Objects

GET - Read Object

Returns a single object with detailed location and telemetry fields.

Endpoint

GET /objects/:id

When to Use

Use this endpoint when opening an object detail page or requesting a single object snapshot by ID.

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.

Path Parameters

Parameter	Type	Required	Description
`id`	number	Yes	Object ID to retrieve.

Query Parameters

This endpoint does not require query parameters.

Request Body

This endpoint does not require a request body.

Example Request

curl --request GET \
  --url https://api.jitra.app/public/v1/objects/101 \
  --header 'x-api-key: <api_key>'

Example Response

Successful response (200 OK):

{
  "statusCode": 200,
  "result": {
    "id": 101,
    "name": "Truck 01",
    "ident": "B-1234-XYZ",
    "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",
    "time_last_idle": "2026-05-17T00:55:00.000Z",
    "time_last_move": "2026-05-17T00:40:00.000Z",
    "time_last_stop": "2026-05-17T00:20:00.000Z",
    "engine_hours": 1723.4,
    "engine_hours_type": "engine_hours",
    "odometer": 120034.7,
    "odometer_type": "odometer",
    "vehicle_data": {
      "vin": "MH4ABC12345678901",
      "plate_number": "B1234XYZ"
    },
    "mileage": 256.4,
    "address": "Jakarta",
    "accuracy": {
      "device_timezone": "Asia/Jakarta",
      "maximum_hdop": 5,
      "minimum_difference_point": 5,
      "minimum_gps_level": 3,
      "idle_speed_threshold": 5,
      "minimum_moving_speed": 10,
      "distance_source": "gps",
      "stop_detection_method": "speed"
    },
    "created_at": "2024-01-01T00:00:00.000Z"
  }
}

Response Fields

All fields below are taken from the result object.

Field	Type	Description
`id`	number	Object ID.
`name`	string	Object display name.
`ident`	string	Unique object identifier.
`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.
`time_last_idle`	string (ISO 8601 datetime)	Last idle timestamp.
`time_last_move`	string (ISO 8601 datetime)	Last moving timestamp.
`time_last_stop`	string (ISO 8601 datetime)	Last stop timestamp.
`engine_hours`	number	Engine-hours value.
`engine_hours_type`	string	Engine-hours source/type value.
`odometer`	number	Odometer value.
`odometer_type`	string	Odometer source/type value.
`vehicle_data`	object	Vehicle metadata.
`vehicle_data.vin`	string	Vehicle VIN.
`vehicle_data.plate_number`	string	Vehicle plate number.
`mileage`	number	Mileage value.
`address`	string	Latest known address.
`accuracy`	object	Tracking accuracy settings.
`accuracy.device_timezone`	string	Device timezone.
`accuracy.maximum_hdop`	number	Maximum allowed HDOP.
`accuracy.minimum_difference_point`	number	Minimum point distance difference.
`accuracy.minimum_gps_level`	number	Minimum GPS level.
`accuracy.idle_speed_threshold`	number	Idle speed threshold.
`accuracy.minimum_moving_speed`	number	Minimum moving speed.
`accuracy.distance_source`	string	Distance calculation source.
`accuracy.stop_detection_method`	string	Stop detection method.
`created_at`	string (ISO 8601 datetime)	Record creation timestamp.

Error Responses

Main Error Responses

HTTP Status	Example `errorCode`	When It Happens
401	`ERR999`	API key is missing, invalid, or expired.
400	`PUBLIC.400_xxx`	The request format or parameter values are invalid.

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 for the current organization throttle window.

Notes

This endpoint combines persisted object data with the latest realtime values when available.