v1 Live

CrewRef REST API

Integrate crew reference verification directly into your recruitment platform, ATS, or crew management system. Verify references programmatically with a simple API call.

Capabilities

What's Available

Reference Verification

Verify if a crew member has active, confirmed references — by email, CrewRef ID, or verification code.

CrewRef ID Lookup

Every member has a unique CrewRef ID (CR-XXXXXXXX) tied to their name. Look up their valid references by ID — no email addresses needed.

Referee Confirmation

Check if a reference was issued by a specific referee — match by referee email to confirm authenticity.

API Keys & Rate Limiting

Secure access with API keys, audit-logged lookups, and generous rate limits for integration partners.

Endpoint

GET /api/v1/verify

Look up a crew member's references by email address.

# Request

curl -G "https://crewref.com/api/v1/verify" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "crew_email=john@example.com" \
  --data-urlencode "referee_email=captain@vessel.com"

# Response

{
  "verified": true,
  "reference_count": 2,
  "references": [
    {
      "vessel": "M/Y EXAMPLE",
      "position": "Chief Officer",
      "status": "active",
      "validity": "valid",
      "service_from": "2024-05-01",
      "service_to": "2025-11-30",
      "issued_at": "2026-01-15T10:22:00.000Z",
      "verify_url": "https://crewref.com/r/a1b2c3d4e5f6"
    }
  ]
}

Endpoint

GET /api/v1/crew

Look up a crew member by their public CrewRef ID and get their name plus valid references. Members find their ID in Dashboard → Settings and share it on CVs and applications.

# Request

curl -G "https://crewref.com/api/v1/crew" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  --data-urlencode "crew_id=CR-12345678"

# Response

{
  "crew_id": "CR-12345678",
  "name": "John Smith",
  "verified": true,
  "reference_count": 2,
  "valid_reference_count": 1,
  "references": [
    {
      "vessel": "M/Y EXAMPLE",
      "position": "Chief Officer",
      "status": "active",
      "validity": "valid",
      "service_from": "2024-05-01",
      "service_to": "2025-11-30",
      "issued_at": "2026-01-15T10:22:00.000Z",
      "verify_url": "https://crewref.com/r/a1b2c3d4e5f6"
    }
  ]
}

Validity: active → valid · pending_approval → pending · revoked → revoked. Draft references are never returned.

Need an API key? Get in touch and we'll set up your integration.

Request an API Key Back to Home