Crew compliance snapshot (scope: crew:compliance:read)
Compliance for a crew member on a vessel, as a unified requirement matrix.
Each requirements[] row is one role requirement (Medical / STCW /
certificate / qualification) with its own status and the satisfied_by
document(s). Verdicts come from the dashboard compliance engine (single
source of truth); this service never re-derives compliance. Falls back to the
crewCompliance projection (STCW + Medical) if the engine is unavailable.
404 if the crew is not on an attached vessel. Pass vessel_id when the crew
has placements on multiple attached vessels.
Authorizations
Partner API key (cpk_live_* / cpk_test_*) as a Bearer token.
Path Parameters
Query Parameters
Body
POST /employers/me/crew/{id}/compliance-checks request body.
Currently empty: the endpoint returns the crew member's current compliance
projection as-is. Point-in-time (as_of) and required-cert filtering are
intentionally not exposed yet — honouring them would mean re-deriving
compliance here, which is forbidden (CLAUDE.md). They will return when the
underlying snapshot supports them.
Response
Successful Response
Compliance for a crew member on a vessel, as a unified requirement matrix.
Each requirements[] row is one role requirement carrying its own
status and the satisfied_by document(s). Verdicts come from the
dashboard compliance engine (single source of truth); this service only
reshapes them and never re-derives compliance. compliance_source says
whether the live engine or the crewCompliance fallback produced the
result. summary always reconciles with requirements.
Requirement counts. Always reconciles: the parts sum to total and
total equals the number of rows in requirements.