Enable a vessel for tracking

Production

https://api.polestar-production.com

PUT

/purpletrac/v1/transaction/{id}/track

Enable tracking and start generating positional data and event notifications for a vessel.

Refer to Tracking a Vessel to see how this endpoint is used in the vessel tracking workflow.

Request

Authorization

API Key

Add parameter in query

api_key

Example:

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

Path Params

Query Params

Body Params application/json

Examples

Responses

🟢200OK

application/json

Tracking was requested. The transaction moves to Ready to Track, "status": "R", and produces positions once our tracking service approves it.

Bodyapplication/json

🟠401Unauthorized

🟠404Record Not Found

🟠409

🔴500Server Error

Request Example

Shell

JavaScript

Java

Swift

cURL

Track indefinitelyTrack a known voyage

curl --location --request PUT 'https://api.polestar-production.com/purpletrac/v1/transaction//track?username=undefined&api_key=%3Capi-key%3E' \
--header 'Content-Type: application/json' \
--data '{}'

Response Example

200 - Default

{
    "added_via": "MANUAL",
    "ais_gap_status": "F",
    "ais_received": null,
    "ais_reporting": true,
    "auto_deregister": false,
    "auto_deregistered": false,
    "auto_register": true,
    "blv": null,
    "carbon_rating_screen": false,
    "client_reference": null,
    "closed_date": null,
    "container_screen_id": null,
    "creation_date": "2023-12-06T16:03:55.335567",
    "has_gaps": true,
    "id": 2854829,
    "inmarsatc_expected": null,
    "inmarsatc_interval": 2,
    "inmarsatc_received": null,
    "inmarsatc_reporting": true,
    "only_tracking_by_ais": false,
    "overall_severity": "WARNING",
    "registered_date": null,
    "registered_name": "9744051",
    "report_generation_complete": true,
    "resource_uri": "/api/v1/transaction/2854829",
    "screened_date": "2023-12-06T16:04:02.896743",
    "screening_status": "WARNING",
    "ship": "/api/v1/shipdetails/376523",
    "status": "R",
    "tracking_date": null,
    "tracking_expiry": null,
    "transceiver_domain": "",
    "transceiver_domain_id": "",
    "user": "/api/v1/user/6913",
    "voyage": null
}

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

Tracking a vessel

Remove additional entities from a tracked vessel