Objects

Read Object Positions

Returns historical positions for a single object between from and to timestamps.

Endpoint

GET /objects/:id/positions

When to Use

Use this endpoint for trip playback, breadcrumb maps, and historical movement analytics.

Authentication

This endpoint requires an API key. Send either x-api-key: <api_key> or Authorization: Bearer <api_key>.
Requests are rate-limited per organization and API usage limits are applied per object.

Path Parameters

Parameter	Type	Required	Description
`id`	number	Yes	Object ID to query position history.

Query Parameters

Parameter	Type	Required	Description
`from`	string (date or datetime)	Yes	Start time for the history range.
`to`	string (date or datetime)	Yes	End time for the history range.
`limit`	number	No	Maximum number of position rows returned.

Example Request

curl --request GET \
  --url 'https://api.jitra.app/public/v1/objects/101/positions?from=2026-05-16T00:00:00.000Z&to=2026-05-17T00:00:00.000Z&limit=100' \
  --header 'x-api-key: <api_key>'

Example Response

Successful response (200 OK):

{
  "statusCode": 200,
  "result": [
    {
      "id": 101,
      "ident": "B-1234-XYZ",
      "name": "Truck 01",
      "latitude": -6.2,
      "longitude": 106.8,
      "altitude": 15,
      "angle": 230,
      "speed": 42,
      "time_server": "2026-05-16T10:00:00.000Z",
      "time_device": "2026-05-16T09:59:58.000Z",
      "engine_hours": 1723.4,
      "odometer": 120034.7,
      "mileage": 256.4,
      "address": "Jakarta"
    }
  ]
}

Response Fields

All fields below are taken from each object inside result.

Field	Type	Description
`id`	number	Object ID.
`ident`	string	Unique object identifier.
`name`	string	Object display name.
`latitude`	number	Latitude value.
`longitude`	number	Longitude value.
`altitude`	number	Altitude value.
`angle`	number	Heading angle.
`speed`	number	Speed value at that point.
`time_server`	string (ISO 8601 datetime)	Server timestamp at that point.
`time_device`	string (ISO 8601 datetime)	Device timestamp at that point.
`engine_hours`	number	Engine-hours value.
`odometer`	number	Odometer value.
`mileage`	number	Mileage value.
`address`	string	Address at that point.

Error Responses

Main Error Responses

HTTP Status	`errorCode`	When It Happens
401	`ERR999`	API key is missing, invalid, or expired.
400	`PUBLIC.400_001`	`from` query parameter is missing.
400	`PUBLIC.400_002`	`to` query parameter is missing.

Other Error Responses

HTTP Status	`errorCode`	When It Happens
404	`PUBLIC.404_001`	The object ID is not found in the authenticated organization.
429	`ERR999`	Too many requests or API usage limit reached.

Notes

The endpoint returns an empty array when no position data exists in the requested time range.