Historical Vessel Data

Historical AIS positions for a vessel

Changed on Sep 8, 2026

Returns a time-series of past AIS positions for one vessel. Use days for a relative window, or from/to for an absolute range. Data is available from 10 August 2021 onward. Only position changes are stored, so a stationary vessel may have gaps.

Credit cost: 2 credits per calendar date returned. Billing is per date returned, not per day requested. A window of N days usually spans N+1 UTC dates, so days=1 typically costs 4 credits. Dates with no position data are not charged.

get/api/v0/vessel_history

Request

Base URL
https://api.datalastic.com
Auth
- API key in header x-api-key
- or API key in query parameter api-key
TypeScript
https://skmtc.dev/datalastic/apis/datalastic-maritime-api/docs/api/v0/vessel_history/get.ts
A function with typed inputs. Its response is checked against the schema.

Query parameters

mmsistring

imostring

uuidstring uuid

daysinteger

Number of days back from today.

fromstring date

Start of date range (yyyy-mm-dd).

tostring date

End of date range (yyyy-mm-dd).

Response

Ordered list of historical position records.

Example response

{
  "data": [
    {
      "timestamp_UTC": "2021-09-15T12:34:00Z",
      "timestamp_epoch": 1631709240
    }
  ],
  "meta": {
    "duration": 0.012,
    "endpoint": "/api/v0/vessel",
    "success": true,
    "next": "00e32b7a-4067-d6b2-8d73-2bdda4fe72bb"
  }
}

Changes

Sep 8, 2026a29cf323d1c3 Revision changes
- warning
  deleted the query request parameter api-key
- info
  added the media type application/json for the response with the status
- info
  added the media type application/json for the response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the non-success response with the status
- info
  added the optional property / to the response with the status

Operation history