> ## Documentation Index > Fetch the complete documentation index at: https://docs.digitalseaservice.com/llms.txt > Use this file to discover all available pages before exploring further. # List the authenticated user's vessel history ## OpenAPI ````yaml /api-reference/openapi.json get /v1/me/vessels openapi: 3.1.0 info: title: DSS Public API description: >- Public OAuth 2.0 API for Digital Sea Service. See https://docs.digitalseaservice.com for the developer guide. version: 1.0.0 contact: name: DSS Developer Support email: admin@digitalseaservice.com url: https://docs.digitalseaservice.com license: name: Proprietary termsOfService: https://digitalseaservice.com/terms servers: - url: https://api.digitalseaservice.com description: Production - url: https://api.dev.digitalseaservice.com description: Sandbox (dev) security: [] paths: /v1/me/vessels: get: tags: - vessels summary: List the authenticated user's vessel history operationId: list_vessels_v1_me_vessels_get parameters: - name: cursor in: query required: false schema: anyOf: - type: string - type: 'null' description: Opaque cursor from a prior response. title: Cursor description: Opaque cursor from a prior response. - name: limit in: query required: false schema: anyOf: - type: integer maximum: 200 minimum: 1 - type: 'null' description: Page size; max 200. title: Limit description: Page size; max 200. responses: '200': description: Successful Response content: application/json: schema: $ref: '#/components/schemas/VesselsResponse' '304': description: Resource has not changed since the conditional header. '400': description: '`invalid_request` — a query parameter (e.g. cursor) was malformed.' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: >- `invalid_token` — bearer token missing, malformed, expired, or revoked. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: '`insufficient_scope` — the token lacks the required scope.' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '422': description: >- `invalid_request` — request validation failed; see the `errors` array. content: application/problem+json: schema: $ref: '#/components/schemas/ValidationProblemDetails' '429': description: '`rate_limit_exceeded` — per-client request budget exhausted.' content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' '500': description: >- `internal_error` — an unexpected error occurred; reference `instance`. content: application/problem+json: schema: $ref: '#/components/schemas/ProblemDetails' security: - oauth2: - vessels:read - bearerAuth: [] components: schemas: VesselsResponse: properties: user_id: type: string title: User Id vessels: items: $ref: '#/components/schemas/_VesselPeriod' type: array title: Vessels next_cursor: anyOf: - type: string - type: 'null' title: Next Cursor description: >- Opaque cursor for the next page. ``null`` when the page is the last one. record_updated_at: type: string format: date-time title: Record Updated At description: >- Most-recently-updated crew-list record for the user. Same value across every page of a stable scan — drives the page-stable ``ETag``. type: object required: - user_id - vessels - record_updated_at title: VesselsResponse description: Page of vessel periods for the authenticated user. example: 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 ProblemDetails: type: object description: >- RFC 7807 Problem Details. Returned with the `application/problem+json` content type on every resource (`/v1/*`) error. properties: type: type: string format: uri description: Stable URL identifying the error type; resolves to its docs page. title: type: string description: Short, human-readable summary of the error type. status: type: integer description: HTTP status code. detail: type: string description: Explanation specific to this occurrence. instance: type: string description: Request correlation id; matches the `X-Request-Id` header. required: - type - title - status - detail - instance ValidationProblemDetails: description: Problem Details for a 422, carrying a per-field `errors` array. allOf: - $ref: '#/components/schemas/ProblemDetails' - type: object properties: errors: type: array description: One entry per field that failed validation. items: type: object additionalProperties: true _VesselPeriod: properties: id: type: string title: Id description: Stable identifier for this vessel period (crew-list id). name: type: string title: Name imo: anyOf: - type: string - type: 'null' title: Imo description: IMO number as a string when DSS holds it, else ``null``. role: anyOf: - type: string - type: 'null' title: Role description: Rank/position served in this period. period_start: type: string format: date-time title: Period Start period_end: anyOf: - type: string format: date-time - type: 'null' title: Period End description: '``null`` while still aboard.' days: type: integer minimum: 0 title: Days description: Qualifying sea-service days logged in the period. nautical_miles: type: integer minimum: 0 title: Nautical Miles type: object required: - id - name - period_start - days - nautical_miles title: _VesselPeriod description: A single period the crew member served on a vessel. example: 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 securitySchemes: oauth2: type: oauth2 description: >- OAuth 2.0 Authorization Code flow with PKCE. See the integration guide at docs.digitalseaservice.com for the full step-by-step. flows: authorizationCode: authorizationUrl: https://api.digitalseaservice.com/oauth/authorize tokenUrl: https://api.digitalseaservice.com/oauth/token refreshUrl: https://api.digitalseaservice.com/oauth/token scopes: profile:read: Read the crew member's name, role, country, and photo URL. seatime:read: Read aggregate sea-time totals and the 12-month trend. vessels:read: Read the crew member's vessel history. bearerAuth: type: http scheme: bearer bearerFormat: Opaque ````