List container trace

get

https://demo.vizionapi.com/references/{referenceId}/trace

⚠️
Pro Tier Only
For access, please contact support.

Returns an array of vessel movements for a given reference id.

Vessel movements are identified using the latest update.

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

referenceId

uuid

required

Id of a created reference

Query Params

include_projected

boolean

Defaults to false

Include projected (forecast) vessel trace points alongside actual ones. Requires the projected trace capability: without it the response is unchanged — actual points only, with no kind field. Contact [email protected] to have it enabled.

page

integer

≥ 1

Defaults to 1

Requested paginated page (1-indexed). Pagination is opt-in and driven by limit, so page has no effect unless limit is also provided. See pagination.

limit

integer

1 to 20000

Requested limit per paginated page. Providing limit enables pagination; omit it to receive the full trace in one response.

include_metadata

boolean

Defaults to false

Include pagination metadata in response. Applies only when limit is also provided. See pagination.

Responses

200Container trace for a reference

204No update found for the given reference

4XXInvalid request