Skip to main content
GET
Get Historical Vessel Data
Retrieve historical vessel positions for voyage reconstruction and route analysis.
Credits: 5 credits per unique date in results (variable total)

Date Format

Dates must be provided in ISO 8601 format:

Limits

  • Maximum date range: 90 days per request
  • Returns up to 3,000 positions per request
  • Historical data extends back 2 years
Need more than 90 days? Make multiple requests with consecutive date ranges. For example, to get 6 months of data, make 2 requests covering 90 days each.
This endpoint currently uses terrestrial AIS data only. Satellite AIS coverage will be added in a future update.

Pricing

Credits are calculated based on the number of unique calendar dates in your results, not the number of positions returned.

Response Fields

Each position includes:
  • lat: Latitude
  • lng: Longitude
  • course: Course over ground
  • speed: Speed over ground
  • time: ISO 8601 timestamp

Authorizations

x-api-key
string
header
required

Your personal API key found in your profile dashboard at https://datadocked.com/dashboard/my_keys

Query Parameters

imo_or_mmsi
string
required

The IMO or MMSI number of the vessel you want to retrieve historical positions for.

from_date
string<date-time>
required

Beginning of the date range in ISO 8601 format.

to_date
string<date-time>
required

End of the date range in ISO 8601 format.

Response

Successful response with historical positions

status
string
data
object[]