Skip to main content
GET
/
get-vessel-historical-data
Get Historical Vessel Data
curl --request GET \
  --url https://datadocked.com/api/vessels_operations/get-vessel-historical-data \
  --header 'x-api-key: <api-key>'
{
  "status": "<string>",
  "data": [
    {
      "lat": 123,
      "lng": 123,
      "course": 123,
      "speed": 123,
      "time": "2023-11-07T05:31:56Z"
    }
  ]
}
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: 
from_date=2026-01-23T00:00:00Z
to_date=2026-02-06T23:59:59Z

​
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.
Date RangeEstimated Credits
1 day5 credits
1 week35 credits
2 weeks70 credits

​
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[]