Historical Vessel Track
Production
https://api.polestar-production.com
Production
https://api.polestar-production.com
POST
https://api.polestar-production.com
geographic area) over a time window, grouped by vessel.
POST because thefilter carries nested objects (a vessel identifier, and a geographic
filter holding either a circle or a polygon ring of coordinate pairs),
which cannot be sent in a query string at a usable length.
timestamp_start and timestamp_end, and at least one ofvessel or geographic_filter. When vessel is present, exactly oneof
mmsi, imo_number or fleet_id must be set. The window may notexceed 731 days, and neither bound may be in the future.
meta.next_cursor back as cursor.Request
Query Params
Body Params application/jsonRequired
Responses
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://api.polestar-production.com/meridia-voyage-intelligence/v1/historical?limit=100&cursor=2026-06-20T04%3A37%3A27&offset=100' \
--header 'api-key: <api-key>' \
--header 'Content-Type: application/json' \
--data '{
"timestamp_start": "2026-05-27T00:00:00Z",
"timestamp_end": "2026-05-28T00:00:00Z",
"vessel": {
"imo_number": "9358890"
},
"downsampling_frequency": 360
}'Response Response Example
200 - One vessel with ten 6-hourly downsampled positions
{
"meta": {
"limit": 10,
"next_cursor": "2026-06-20T04:37:27",
"request_id": "fd528b10-dc47-4298-a584-f1865ee8cc44",
"request_timestamp": "2026-06-30T04:37:07Z"
},
"data": [
{
"vessel": {
"asset_id": "34eb398f-ded3-4ace-9c9b-2725d9f88dc7",
"mmsi": "538006864",
"imo_number": 9749269,
"name": "DSI AQUARIUS",
"call_sign": "V7SH4",
"ship_type": "Bulk Carrier",
"flag": {
"name": "Marshall Islands",
"country_code": "MHL"
}
},
"voyages": [
{
"position_timestamp": "2026-06-24T23:29:37Z",
"source": "S_AIS",
"latitude": -49.14374598521637,
"longitude": -78.69539856304687,
"speed": 10.8,
"course": 155,
"heading": 149,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.3
},
{
"position_timestamp": "2026-06-24T22:29:16Z",
"source": "S_AIS",
"latitude": -48.98003878468767,
"longitude": -78.81368560758327,
"speed": 10.8,
"course": 151,
"heading": 154,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.3
},
{
"position_timestamp": "2026-06-24T21:23:13Z",
"source": "S_AIS",
"latitude": -48.806843215514746,
"longitude": -78.94074700738166,
"speed": 10.6,
"course": 181,
"heading": 177,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.3
},
{
"position_timestamp": "2026-06-24T20:09:14Z",
"source": "S_AIS",
"latitude": -48.61099401731797,
"longitude": -78.8720255920375,
"speed": 9.6,
"course": 207,
"heading": 205,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.2
},
{
"position_timestamp": "2026-06-24T19:03:58Z",
"source": "S_AIS",
"latitude": -48.458341276839455,
"longitude": -78.75640075960206,
"speed": 9.1,
"course": 214,
"heading": 205,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.2
},
{
"position_timestamp": "2026-06-24T17:57:05Z",
"source": "S_AIS",
"latitude": -48.30728959514137,
"longitude": -78.6544832309072,
"speed": 9,
"course": 204,
"heading": 208,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.2
},
{
"position_timestamp": "2026-06-24T16:53:03Z",
"source": "S_AIS",
"latitude": -48.165430442402176,
"longitude": -78.56441033591628,
"speed": 8.5,
"course": 218,
"heading": 207,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.2
},
{
"position_timestamp": "2026-06-24T15:50:14Z",
"source": "S_AIS",
"latitude": -48.02250448484727,
"longitude": -78.48080795417124,
"speed": 8.9,
"course": 200,
"heading": 205,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.2
},
{
"position_timestamp": "2026-06-24T14:44:15Z",
"source": "S_AIS",
"latitude": -47.855059970166245,
"longitude": -78.45642104194907,
"speed": 9.5,
"course": 179,
"heading": 180,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.2
},
{
"position_timestamp": "2026-06-24T13:44:00Z",
"source": "S_AIS",
"latitude": -47.6969887224874,
"longitude": -78.46792806173946,
"speed": 8.7,
"course": 193,
"heading": 182,
"navigational_status": {
"status": "Under way using engine",
"code": 1
},
"transceiver_class": "A",
"raw_destination": "ES LPA",
"matched_destination": {
"port_name": "Las Palmas De Gran Canaria",
"unlocode": "ESLPA",
"country": "Kingdom of Spain"
},
"eta": "2026-07-20T07:00:00Z",
"draught": 11.2
}
]
}
]
}Modified at 2026-10-21 13:57:11