GET
/
v1
/
me
/
vessels
List the authenticated user's vessel history
curl --request GET \
  --url https://api.digitalseaservice.com/v1/me/vessels \
  --header 'Authorization: Bearer <token>'
{
  "next_cursor": "eyJsYXN0X2lkIjoiMDFIVjlYS...",
  "record_updated_at": "2026-05-22T14:21:00Z",
  "user_id": "65a1f0e2c3b4d5e6f7a8b9c0",
  "vessels": [
    {
      "days": 99,
      "id": "69961ffbbd7419b471faab60",
      "imo": "1012725",
      "name": "M/V Endeavour",
      "nautical_miles": 4280,
      "period_end": "2025-04-20T00:00:00Z",
      "period_start": "2025-01-12T00:00:00Z",
      "role": "Chief Officer"
    }
  ]
}

Authorizations

​
Authorization
string
header
required

OAuth 2.0 Authorization Code flow with PKCE. See the integration guide at docs.digitalseaservice.com for the full step-by-step.

Query Parameters

​
cursor
string | null

Opaque cursor from a prior response.

​
limit
integer | null

Page size; max 200.

Required range: 1 <= x <= 200

Response

Successful Response

Page of vessel periods for the authenticated user.

​
user_id
string
required
​
vessels
_VesselPeriod · object[]
required
​
record_updated_at
string<date-time>
required

Most-recently-updated crew-list record for the user. Same value across every page of a stable scan — drives the page-stable ETag.

​
next_cursor
string | null

Opaque cursor for the next page. null when the page is the last one.