Voyage assessments

List voyage assessments

Returns your assessment history newest-first as summary rows: id, your customer_reference, the route, the score, the risk level and the confidence. This is the audit view. Until 2026-09-05 there was no way to enumerate what you had scored — a caller had to persist every returned id at the moment of creation or the record was unreachable, and assessments expire, so "I will fetch it later" had a deadline you could not list against. Fetch the full record with GET /api/v1/voyage-assessments/{id}, or archive the lot with POST /api/v1/exports (resource voyage_assessments) before it expires. Pagination is KEYSET, not offset: pass the returned next_cursor back as cursor. Assessments written by one batch share a timestamp, and an offset walk over them silently skips rows — in an audit export that is a missing record. Route geometry is NOT included in the summary: it is ~87% of an assessment body and nobody paging an index wants it.

Required scope: voyage:score.

get/api/v1/voyage-assessments

Request

  • Base URL: https://arcnautical.com
  • URL: https://arcnautical.com/api/v1/voyage-assessments
  • Auth: one of:
    • HTTP bearer
    • API key in header X-ArcNautical-Key

Query parameters

limitinteger

Rows per page, 1-200. Default 50.

cursorstring

The next_cursor from the previous page, passed back unmodified.

customer_referencestring

Exact match on the reference you supplied at creation.

origin_locodestring

UN/LOCODE of the origin port.

dest_locodestring

UN/LOCODE of the destination port.

created_afterstring date-time

ISO 8601 lower bound, inclusive.

created_beforestring date-time

ISO 8601 upper bound, inclusive.

Response

Successful response.

next_cursorstring nullable
has_moreboolean required

Changes

No recorded changes to this operation across all 1 revision of this API.