Read One Object

Get object detail

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.jitra.app/public/v1/objects/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jitra.app/public/v1/objects/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jitra.app/public/v1/objects/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.jitra.app/public/v1/objects/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "statusCode": 200,
  "result": {
    "id": 101,
    "name": "Truck 01",
    "ident": "B-1234-XYZ",
    "time_server": "2023-11-07T05:31:56Z",
    "time_device": "2023-11-07T05:31:56Z",
    "time_last_idle": "2023-11-07T05:31:56Z",
    "time_last_move": "2023-11-07T05:31:56Z",
    "time_last_stop": "2023-11-07T05:31:56Z",
    "engine_hours": 1723.4,
    "engine_hours_type": "sensor",
    "odometer": 120034.7,
    "odometer_type": "sensor",
    "vehicle_data": {
      "vin": "MH4ABC12345678901",
      "plate_number": "B1234XYZ"
    },
    "mileage": 256.4,
    "address": "Jakarta",
    "accuracy": {
      "device_timezone": "Asia/Jakarta",
      "maximum_hdop": 123,
      "minimum_difference_point": 123,
      "minimum_gps_level": 123,
      "idle_speed_threshold": 123,
      "minimum_moving_speed": 123,
      "distance_source": "<string>",
      "stop_detection_method": "<string>"
    },
    "created_at": "2023-11-07T05:31:56Z",
    "latitude": -6.2,
    "longitude": 106.8,
    "altitude": 15,
    "angle": 230,
    "speed": 42
  }
}

{
  "statusCode": 401,
  "errorCode": "ERR999",
  "message": "Unauthorized",
  "timestamp": "2026-05-17T01:00:00.000Z"
}

{
  "statusCode": 404,
  "errorCode": "PUBLIC.404_001",
  "message": "Object not found.",
  "timestamp": "2026-05-17T01:00:00.000Z"
}

{
  "statusCode": 429,
  "errorCode": "ERR999",
  "message": "ThrottlerException: Too Many Requests",
  "timestamp": "2026-05-17T01:00:00.000Z"
}

GET

objects

{id}

Get object detail

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

const options = {method: 'GET', headers: {'x-api-key': '<api-key>'}};

fetch('https://api.jitra.app/public/v1/objects/{id}', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.jitra.app/public/v1/objects/{id}",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "x-api-key: <api-key>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

package main

import (
	"fmt"
	"net/http"
	"io"
)

func main() {

	url := "https://api.jitra.app/public/v1/objects/{id}"

	req, _ := http.NewRequest("GET", url, nil)

	req.Header.Add("x-api-key", "<api-key>")

	res, _ := http.DefaultClient.Do(req)

	defer res.Body.Close()
	body, _ := io.ReadAll(res.Body)

	fmt.Println(string(body))

}

require 'uri'
require 'net/http'

url = URI("https://api.jitra.app/public/v1/objects/{id}")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["x-api-key"] = '<api-key>'

response = http.request(request)
puts response.read_body

{
  "statusCode": 200,
  "result": {
    "id": 101,
    "name": "Truck 01",
    "ident": "B-1234-XYZ",
    "time_server": "2023-11-07T05:31:56Z",
    "time_device": "2023-11-07T05:31:56Z",
    "time_last_idle": "2023-11-07T05:31:56Z",
    "time_last_move": "2023-11-07T05:31:56Z",
    "time_last_stop": "2023-11-07T05:31:56Z",
    "engine_hours": 1723.4,
    "engine_hours_type": "sensor",
    "odometer": 120034.7,
    "odometer_type": "sensor",
    "vehicle_data": {
      "vin": "MH4ABC12345678901",
      "plate_number": "B1234XYZ"
    },
    "mileage": 256.4,
    "address": "Jakarta",
    "accuracy": {
      "device_timezone": "Asia/Jakarta",
      "maximum_hdop": 123,
      "minimum_difference_point": 123,
      "minimum_gps_level": 123,
      "idle_speed_threshold": 123,
      "minimum_moving_speed": 123,
      "distance_source": "<string>",
      "stop_detection_method": "<string>"
    },
    "created_at": "2023-11-07T05:31:56Z",
    "latitude": -6.2,
    "longitude": 106.8,
    "altitude": 15,
    "angle": 230,
    "speed": 42
  }
}

{
  "statusCode": 401,
  "errorCode": "ERR999",
  "message": "Unauthorized",
  "timestamp": "2026-05-17T01:00:00.000Z"
}

{
  "statusCode": 404,
  "errorCode": "PUBLIC.404_001",
  "message": "Object not found.",
  "timestamp": "2026-05-17T01:00:00.000Z"
}

{
  "statusCode": 429,
  "errorCode": "ERR999",
  "message": "ThrottlerException: Too Many Requests",
  "timestamp": "2026-05-17T01:00:00.000Z"
}

Authorizations

x-api-key

string

header

required

Organization API key issued from Jitra (Organization → API Key).

Path Parameters

integer

required

Numeric object ID that belongs to the authenticated organization.

Example:

101

Response

Object detail including current location.

statusCode

integer

required

Example:

200

result

object

required

Current location snapshot merged from realtime cache when available.

Hide child attributes

result.id

integer

Object ID.

Example:

101

result.name

string

Object display name.

Example:

"Truck 01"

result.ident

string

Unique device/object identifier (IMEI or similar).

Example:

"B-1234-XYZ"

result.time_server

string<date-time>

Last time the server received a packet from this object.

result.time_device

string<date-time>

Timestamp generated by the device GPS.

result.time_last_idle

string<date-time>

Last time the object was detected as idle.

result.time_last_move

string<date-time>

Last time the object was detected as moving.

result.time_last_stop

string<date-time>

Last time the object was detected as stopped.

result.engine_hours

number

Accumulated engine hours.

Example:

1723.4

result.engine_hours_type

enum<string>

Source of a system counter. system is calculated by Jitra; sensor comes from a device sensor.

Available options:

sensor,

system

result.odometer

number

Odometer value in the organization's distance unit.

Example:

120034.7

result.odometer_type

enum<string>

Source of a system counter. system is calculated by Jitra; sensor comes from a device sensor.

Available options:

sensor,

system

result.vehicle_data

object

Vehicle identity metadata attached to the object.

Hide child attributes

result.vehicle_data.vin

string

Vehicle Identification Number.

Example:

"MH4ABC12345678901"

result.vehicle_data.plate_number

string

Vehicle plate number.

Example:

"B1234XYZ"

result.mileage

number

Trip or period mileage.

Example:

256.4

result.address

string

Latest reverse-geocoded address.

Example:

"Jakarta"

result.accuracy

object

Tracking accuracy and movement-detection settings for the object.

Hide child attributes

result.accuracy.device_timezone

string

IANA timezone used by the device.

Example:

"Asia/Jakarta"

result.accuracy.maximum_hdop

number

Maximum allowed Horizontal Dilution of Precision.

result.accuracy.minimum_difference_point

number

Minimum distance (meters) between consecutive accepted points.

result.accuracy.minimum_gps_level

number

Minimum GPS quality level.

result.accuracy.idle_speed_threshold

number

Speed threshold used to detect idle state.

result.accuracy.minimum_moving_speed

number

Minimum speed treated as movement.

result.accuracy.distance_source

string

Source used to calculate distance, for example gps.

result.accuracy.stop_detection_method

string

Method used to detect stops, for example speed.

result.created_at

string<date-time>

Record creation timestamp.

result.latitude

number

Current latitude.

Example:

-6.2

result.longitude

number

Current longitude.

Example:

106.8

result.altitude

number

Current altitude in meters.

Example:

15

result.angle

number

Heading angle in degrees (0–360).

Example:

230

result.speed

number

Current speed.

Example:

42

Get Started

Endpoints

Authorizations

Path Parameters

Response