Positions

Read Latest Positions

Returns the latest realtime position snapshot for all requested object IDs.

Endpoint

GET /positions/latest

When to Use

Use this endpoint to refresh live map markers or monitor current locations for multiple objects.

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.

Query Parameters

Parameter	Type	Required	Description
`ids`	string	Yes	Comma-separated object IDs, for example `101,102,103`.

Example Request

curl --request GET \
  --url 'https://api.jitra.app/public/v1/positions/latest?ids=101,102' \
  --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-17T01:00:00.000Z",
      "time_device": "2026-05-17T00: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.
`time_server`	string (ISO 8601 datetime)	Last server timestamp.
`time_device`	string (ISO 8601 datetime)	Last device timestamp.
`engine_hours`	number	Engine-hours value.
`odometer`	number	Odometer value.
`mileage`	number	Mileage value.
`address`	string	Latest known address.

Error Responses

Main Error Responses

HTTP Status	`errorCode`	When It Happens
401	`ERR999`	API key is missing, invalid, or expired.
400	`PUBLIC.400_003`	`ids` query parameter is missing or empty.
400	`PUBLIC.400_004`	One or more IDs do not belong to the authenticated organization.

Other Error Responses

HTTP Status	`errorCode`	When It Happens
429	`ERR999`	Too many requests or API usage limit reached.

Notes

When ids resolves to an empty list, the endpoint returns an empty result array.