Objects

GET - Read Objects

Returns a list of objects available to the authenticated organization, including telemetry summary and metadata.

Endpoint

GET /objects

When to Use

Use this endpoint to load the object catalog for dashboards, object selectors, or object overview pages.

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

This endpoint does not require path parameters.

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 \
  --header 'x-api-key: <api_key>'

Example Response

Successful response (200 OK):

{
  "statusCode": 200,
  "result": [
    {
      "id": 101,
      "name": "Truck 01",
      "ident": "B-1234-XYZ",
      "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 each object inside result.

Field	Type	Description
`id`	number	Object ID.
`name`	string	Object display name.
`ident`	string	Unique object identifier.
`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
429	`ERR999`	Too many requests for the current organization throttle window.