Skip to main content
POST
Create Certificate

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id
string<uuid>
required

Body

application/json

Create payload.

certificateType
enum<string>
required

Sub-type discriminator within professional certificates.

Available options:
stcw_basic_safety,
deck_certificate,
gmdss_endorsement,
oil_tanker_endorsement,
medical,
flag_certificate,
other
certificateNumber
string | null
issuingAuthority
string | null
issueDate
string<date> | null
expiryDate
string<date> | null
uploadId
string<uuid> | null
notes
string | null

Response

Successful Response

API response shape with computed status.

id
string<uuid>
required
certificateType
string
required
uploadedByUserId
string<uuid>
required
status
enum<string>
required

Computed at response time from expiry_date - today().

No unknown value — when there's no expiry_date we use VALID (the document doesn't expire; treat as good).

Available options:
valid,
expiring_soon,
expired
createdAt
string<date-time>
required
updatedAt
string<date-time>
required
certificateNumber
string | null
issuingAuthority
string | null
issueDate
string<date> | null
expiryDate
string<date> | null
uploadId
string<uuid> | null
verification
CrewVerificationResponseDTO · object | null

API response shape (camelCase). Used both as the per-item entry in a profile summary and embedded as the verification field on a credential response.

notes
string | null