Retrieve a list of vessels

Production

https://api.polestar-production.com

GET

/purpletrac/v1/sisship

Retrieves all vessels which match the search parameters. You can search for ship by name or IMO Number. If more than one ship matches the name criteria then multiple results will be returned.

Refer to Screening Vessels for an example of how to use this endpoint in a real-life workflow.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

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

Query Params

Responses

🟢200OK

application/json

Vessels matching the search. More than one match is normal, so confirm the IMO number before screening.

Bodyapplication/json

🟠400Bad Request

🟠401Unauthorized

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.polestar-production.com/purpletrac/v1/sisship?username=undefined&limit=undefined&offset=undefined&imo_number__startswith=undefined&ship_name__istartswith=undefined&api_key=%3Capi-key%3E'

Response Example

200 - Single Vessel

{
    "meta": {
        "limit": 20,
        "next": null,
        "offset": 0,
        "previous": null,
        "total_count": 1
    },
    "objects": [
        {
            "flag_alpha_2": "BD",
            "flag_code": "BGD",
            "image": "http://net.polestarglobal.sis-photos.s3.amazonaws.com/1355274_2.jpg",
            "imo_number": "9221126",
            "mmsi": "405000251",
            "ship_name": "STAR ROYAL",
            "ship_status": "In Service/Commission",
            "ship_type": "Bulk Carrier"
        }
    ]
}

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

FAQ

Additional entity search