Ship movement history

Production

https://api.polestar-production.com

GET

/purpletrac/v1/porthistory

Retrieves the ship movement history as a list of positions and port calls.

Refer to Movement History to see how this endpoint is used in a real-life workflow.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

api_key: ********************

Query Params

Responses

🟢200OK

application/json

The vessel's positions and port calls across the screening window, with a severity on each.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/purpletrac/v1/porthistory?username=undefined&limit=undefined&offset=undefined&screen_result_id=undefined&severity__in=undefined&order_by=undefined&api_key=%3Capi-key%3E'

Response Example

200 - Default (incl. pagination)

{
    "meta": {
        "limit": 20,
        "next": "/api/v1/porthistory?screen_result_id=14837193&api_key=&username=&order_by=-entered&limit=20&offset=21",
        "offset": 1,
        "previous": null,
        "total_count": 1162
    },
    "objects": [
        {
            "category": "",
            "country_name": "Bangladesh",
            "departed": null,
            "entered": "2023-11-07T20:54:52+00:00",
            "id": 122455254,
            "port_name": "Chittagong",
            "resource_uri": "/api/v1/porthistory/122455254",
            "screenresult": "/api/v1/screenresult/9783006",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Singapore",
            "departed": "2023-10-22T23:17:26+00:00",
            "entered": "2023-10-22T20:59:32+00:00",
            "id": 122455256,
            "port_name": "Singapore Offshore Terminals",
            "resource_uri": "/api/v1/porthistory/122455256",
            "screenresult": "/api/v1/screenresult/9783006",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Singapore",
            "departed": "2023-10-22T23:17:26+00:00",
            "entered": "2023-10-22T20:59:32+00:00",
            "id": 122455211,
            "port_name": "Singapore Offshore Terminals",
            "resource_uri": "/api/v1/porthistory/122455211",
            "screenresult": "/api/v1/screenresult/9783001",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Singapore",
            "departed": "2023-10-22T20:59:32+00:00",
            "entered": "2023-10-22T17:41:35+00:00",
            "id": 122455212,
            "port_name": "Tanjung Langsat",
            "resource_uri": "/api/v1/porthistory/122455212",
            "screenresult": "/api/v1/screenresult/9783001",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Singapore",
            "departed": "2023-10-22T20:59:32+00:00",
            "entered": "2023-10-22T17:41:35+00:00",
            "id": 122455340,
            "port_name": "Tanjung Langsat",
            "resource_uri": "/api/v1/porthistory/122455340",
            "screenresult": "/api/v1/screenresult/9783011",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Singapore",
            "departed": "2023-10-22T20:59:32+00:00",
            "entered": "2023-10-22T06:40:40+00:00",
            "id": 122455341,
            "port_name": "Singapore Offshore Terminals",
            "resource_uri": "/api/v1/porthistory/122455341",
            "screenresult": "/api/v1/screenresult/9783011",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Singapore",
            "departed": "2023-10-22T20:59:32+00:00",
            "entered": "2023-10-22T06:40:40+00:00",
            "id": 122455258,
            "port_name": "Singapore Offshore Terminals",
            "resource_uri": "/api/v1/porthistory/122455258",
            "screenresult": "/api/v1/screenresult/9783006",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Indonesia",
            "departed": "2023-10-18T17:19:08+00:00",
            "entered": "2023-10-16T21:18:52+00:00",
            "id": 122455259,
            "port_name": "Gresik",
            "resource_uri": "/api/v1/porthistory/122455259",
            "screenresult": "/api/v1/screenresult/9783006",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Indonesia",
            "departed": "2023-10-18T17:19:08+00:00",
            "entered": "2023-10-16T21:18:52+00:00",
            "id": 122455214,
            "port_name": "Gresik",
            "resource_uri": "/api/v1/porthistory/122455214",
            "screenresult": "/api/v1/screenresult/9783001",
            "severity": "OK"
        },
        {
            "category": "",
            "country_name": "Indonesia",
            "departed": "2023-10-16T17:42:02+00:00",
            "entered": "2023-10-15T20:19:20+00:00",
            "id": 122455215,
            "port_name": "Surabaya",
            "resource_uri": "/api/v1/porthistory/122455215",
            "screenresult": "/api/v1/screenresult/9783001",
            "severity": "OK"
        }
    ]
}

Modified at 2026-09-18 08:35:54

Country Sanctions check

Ship-to-Ship (STS) pairing screening