GET
/
v1
/
me
/
sea-time
Get aggregate sea-time totals
curl --request GET \
  --url https://api.digitalseaservice.com/v1/me/sea-time \
  --header 'Authorization: Bearer <token>'
{
  "by_role": [
    {
      "days": 320,
      "role": "Deckhand"
    },
    {
      "days": 480,
      "role": "Bosun"
    },
    {
      "days": 1042,
      "role": "Mate"
    }
  ],
  "record_updated_at": "2026-05-22T14:21:00Z",
  "totals": {
    "days_at_sea": 1842,
    "nautical_miles": 87423,
    "vessels_served": 14,
    "years_active": 6.2
  },
  "user_id": "65a1f0e2c3b4d5e6f7a8b9c0",
  "verified": {
    "days_at_sea": 1680,
    "nautical_miles": 79215
  }
}

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.

Response

Successful Response

Aggregate sea-time totals for the authenticated user.

​
user_id
string
required
​
totals
_DeclaredTotals · object
required

Crew-declared aggregate sea time.

Example:
{
  "days_at_sea": 1842,
  "nautical_miles": 87423,
  "vessels_served": 14,
  "years_active": 6.2
}
​
verified
_VerifiedTotals · object
required

Independently confirmed subset of the declared totals.

Example:
{
  "days_at_sea": 1680,
  "nautical_miles": 79215
}
​
by_role
_RoleBreakdown · object[]
required
​
record_updated_at
string<date-time>
required