{
"statusCode": 429,
"errorCode": "ERR999",
"message": "ThrottlerException: Too Many Requests",
"timestamp": "2026-05-17T01:00:00.000Z"
}
Authorizations
ApiKeyAuthBearerAuth
x-api-key
string
header
required
Organization API key issued from Jitra (Organization → API Key).
Path Parameters
id
integer
required
Numeric object ID that belongs to the authenticated organization.
Example:
101
Query Parameters
from
string<date-time>
required
Start of the history range (date or ISO 8601 datetime). Missing value returns PUBLIC.400_001.
Example:
"2026-05-16T00:00:00.000Z"
to
string<date-time>
required
End of the history range (date or ISO 8601 datetime). Missing value returns PUBLIC.400_002.
Example:
"2026-05-17T00:00:00.000Z"
limit
integer
Maximum number of position rows to return.
Required range: x >= 1
Example:
100
Response
Historical positions for the object.
statusCode
integer
required
Example:
200
result
object[]
required
Hide child attributes
result.id
integer
Object ID.
Example:
101
result.ident
string
Unique object identifier.
Example:
"B-1234-XYZ"
result.name
string
Object display name.
Example:
"Truck 01"
result.latitude
number
Latitude at this point.
Example:
-6.2
result.longitude
number
Longitude at this point.
Example:
106.8
result.altitude
number
Altitude in meters.
Example:
15
result.angle
number
Heading angle in degrees.
Example:
230
result.speed
number
Speed at this point.
Example:
42
result.time_server
string<date-time>
Server timestamp for this point.
result.time_device
string<date-time>
Device timestamp for this point.
result.engine_hours
number
Engine-hours value associated with the object.
result.odometer
number
Odometer value associated with the object.
result.mileage
number
Mileage value associated with the object.
result.address
string
Address at this point, falling back to the object's last known address.
{"docsConfig":{"theme":"mint","$schema":"https://mintlify.com/docs.json","name":"Jitra Documentation","description":"Guides, product documentation, and API resources for Jitra.","colors":{"primary":"#4054a4","light":"#111111","dark":"#FFFFFF"},"logo":{"light":"https://mintcdn.com/jitra/V_6KYV2NQaTyFxel/images/logo-full.png?fit=max\u0026auto=format\u0026n=V_6KYV2NQaTyFxel\u0026q=85\u0026s=0112bf9bc16ea5f2008c91173621c73e","dark":"https://mintcdn.com/jitra/V_6KYV2NQaTyFxel/images/logo-full.png?fit=max\u0026auto=format\u0026n=V_6KYV2NQaTyFxel\u0026q=85\u0026s=0112bf9bc16ea5f2008c91173621c73e"},"favicon":{"light":"https://mintcdn.com/jitra/V_6KYV2NQaTyFxel/images/favicon-32x32.png?fit=max\u0026auto=format\u0026n=V_6KYV2NQaTyFxel\u0026q=85\u0026s=119ca00b4695f28189ab45c947d700e5","dark":"https://mintcdn.com/jitra/V_6KYV2NQaTyFxel/images/favicon-32x32.png?fit=max\u0026auto=format\u0026n=V_6KYV2NQaTyFxel\u0026q=85\u0026s=119ca00b4695f28189ab45c947d700e5"},"api":{"openapi":"openapi.json","params":{"expanded":"all"},"url":"full","mdx":{"auth":{"method":"bearer"},"server":"https://api.jitra.app/public/v1"}},"appearance":{"default":"light"},"navbar":{"links":[]},"icons":{"library":"lucide"},"contextual":{"options":["copy","view","download-pdf"],"display":"header"},"markdown":{"schema":true},"styling":{"latex":false},"navigation":{"languages":[{"language":"en","default":true,"href":"en/introduction/what-is-jitra"},{"language":"id","href":"id/introduction/what-is-jitra"}]}},"deployment":{"deploymentMetadataValue":{"subdomain":"jitra","hasAudioNarration":false,"actualSubdomain":"jitra","customDomains":["docs.jitra.app"],"gitSource":{"type":"github","owner":"appjitra","repo":"docs","deployBranch":"main","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"entitlements":{"AI_CHAT":{"status":"DISABLED"}},"buildId":"6af15962bf49e26bef24e91b","clientVersion":"0.0.4142","searchFilterCounts":[{"language":"en","tag":"Guides","count":145},{"language":"id","tag":"Guides","count":145},{"language":"en","tag":"Administration","count":28},{"language":"id","tag":"Administration","count":28},{"language":"en","tag":"Changelog","count":16},{"language":"id","tag":"Changelog","count":16},{"language":"en","tag":"Analytics","count":14},{"language":"id","tag":"Analytics","count":14},{"language":"en","tag":"Places","count":12},{"language":"en","tag":"Tracking","count":12},{"language":"en","tag":"Troubleshooting","count":12},{"language":"id","tag":"Places","count":12},{"language":"id","tag":"Tracking","count":12},{"language":"id","tag":"Troubleshooting","count":12},{"language":"en","tag":"API \u0026 Integrations","count":10},{"language":"en","tag":"Events \u0026 Notifications","count":10},{"language":"en","tag":"Objects","count":10},{"language":"id","tag":"API \u0026 Integrations","count":10},{"language":"id","tag":"Events \u0026 Notifications","count":10},{"language":"id","tag":"Objects","count":10}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":false,"hasWebMcpPermissions":false,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":false},"customCss":[],"page":{"pagePath":"en/api-reference/endpoints/read-object-positions","slug":"/en/api-reference/endpoints/read-object-positions","pageMetadata":{"title":"Read Object Positions","sidebarTitle":"Object Positions","description":"Returns historical positions for one Object within a required date or datetime range.","openapi":"openapi.json GET /objects/{id}/positions","href":"/en/api-reference/endpoints/read-object-positions"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Returns historical positions for one Object within a required date or datetime range.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){return _jsx(_Fragment,{})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Read Object Positions","sidebarTitle":"Object Positions","description":"Returns historical positions for one Object within a required date or datetime range.","openapi":"openapi.json GET /objects/{id}/positions","href":"/en/api-reference/endpoints/read-object-positions"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[],"codeExamples":{}},"jsLinks":[],"openApiReferenceData":{"operation":{"tags":["Objects"],"operationId":"getObjectPositions","summary":"Get object position history","description":"Returns historical positions for one Object within a required date or datetime range.","parameters":["27b8ec3f-b7af-4609-958c-85d9941b93d9","64d4abbb-3d7a-4cc2-97ba-6ac828de29c8","3fd619bd-0af8-4468-af45-19f2dfe4e76a","c54fd0ce-e0ea-4256-902d-b95d622bcab2"],"responses":{"200":"c06010b3-65fd-434d-8df0-05f5c59019bb","400":"d495f133-0f0b-468e-860d-482c58b6b9f7","401":"6cd5bf36-81c7-4b29-a4a9-f3c7be38a6e4","403":"e6b4bdd9-3b27-4e62-b0bb-f6dfe569d582","404":"7167f938-b4f0-4c10-a2af-c665ff7a7e4d","429":"3b711654-de4e-4144-9a85-679598db6880"},"method":"get","type":"path","servers":["e238673c-bfd4-4a14-8e29-539a4974a3d8","ec7d20b4-50b0-4ca9-8699-4feaf628a552"],"security":["66731604-e134-494e-a5f8-aee6e12ee006","b320dd9c-5424-4a12-b7e0-5c5d8423562e"],"path":"/objects/{id}/positions","baseUrlOptions":["https://api.jitra.app/public/v1","{scheme}://{host}:{port}/public/v1"],"title":"Get object position history","codeSamples":[],"requiredOnlyExamples":false,"requestExampleType":"generated","responseExampleType":"generated","urlDisplay":"full"},"dependencies":{"parameters":{"27b8ec3f-b7af-4609-958c-85d9941b93d9":{"name":"id","in":"path","required":true,"description":"Numeric object ID that belongs to the authenticated organization.","schema":{"type":"integer","example":101,"isRequired":true,"description":"Numeric object ID that belongs to the authenticated organization.","uniqueKey":"","typeLabel":"integer"}},"64d4abbb-3d7a-4cc2-97ba-6ac828de29c8":{"name":"from","in":"query","required":true,"description":"Start of the history range (date or ISO 8601 datetime). Missing value returns `PUBLIC.400_001`.","schema":{"type":"string","format":"date-time","example":"2026-05-16T00:00:00.000Z","isRequired":true,"description":"Start of the history range (date or ISO 8601 datetime). Missing value returns `PUBLIC.400_001`.","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"3fd619bd-0af8-4468-af45-19f2dfe4e76a":{"name":"to","in":"query","required":true,"description":"End of the history range (date or ISO 8601 datetime). Missing value returns `PUBLIC.400_002`.","schema":{"type":"string","format":"date-time","example":"2026-05-17T00:00:00.000Z","isRequired":true,"description":"End of the history range (date or ISO 8601 datetime). Missing value returns `PUBLIC.400_002`.","uniqueKey":"","typeLabel":"string\u003cdate-time>"}},"c54fd0ce-e0ea-4256-902d-b95d622bcab2":{"name":"limit","in":"query","required":false,"description":"Maximum number of position rows to return.","schema":{"type":"integer","minimum":1,"example":100,"isRequired":false,"description":"Maximum number of position rows to return.","uniqueKey":"","typeLabel":"integer"}}},"responses":{"c06010b3-65fd-434d-8df0-05f5c59019bb":{"description":"Historical positions for the object.","content":{"application/json":{"schema":{"type":"object","required":["statusCode","result"],"properties":{"statusCode":{"type":"integer","example":200,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"result":{"type":"array","items":{"type":"object","description":"GPS position snapshot for an object. Used by both latest-position and history endpoints.","properties":{"id":{"type":"integer","description":"Object ID.","example":101,"uniqueKey":"result.items.[INDEX].id","typeLabel":"integer"},"ident":{"type":"string","description":"Unique object identifier.","example":"B-1234-XYZ","uniqueKey":"result.items.[INDEX].ident","typeLabel":"string"},"name":{"type":"string","description":"Object display name.","example":"Truck 01","uniqueKey":"result.items.[INDEX].name","typeLabel":"string"},"latitude":{"type":"number","description":"Latitude at this point.","example":-6.2,"uniqueKey":"result.items.[INDEX].latitude","typeLabel":"number"},"longitude":{"type":"number","description":"Longitude at this point.","example":106.8,"uniqueKey":"result.items.[INDEX].longitude","typeLabel":"number"},"altitude":{"type":"number","description":"Altitude in meters.","example":15,"uniqueKey":"result.items.[INDEX].altitude","typeLabel":"number"},"angle":{"type":"number","description":"Heading angle in degrees.","example":230,"uniqueKey":"result.items.[INDEX].angle","typeLabel":"number"},"speed":{"type":"number","description":"Speed at this point.","example":42,"uniqueKey":"result.items.[INDEX].speed","typeLabel":"number"},"time_server":{"type":"string","format":"date-time","description":"Server timestamp for this point.","uniqueKey":"result.items.[INDEX].time_server","typeLabel":"string\u003cdate-time>"},"time_device":{"type":"string","format":"date-time","description":"Device timestamp for this point.","uniqueKey":"result.items.[INDEX].time_device","typeLabel":"string\u003cdate-time>"},"engine_hours":{"type":"number","description":"Engine-hours value associated with the object.","uniqueKey":"result.items.[INDEX].engine_hours","typeLabel":"number"},"odometer":{"type":"number","description":"Odometer value associated with the object.","uniqueKey":"result.items.[INDEX].odometer","typeLabel":"number"},"mileage":{"type":"number","description":"Mileage value associated with the object.","uniqueKey":"result.items.[INDEX].mileage","typeLabel":"number"},"address":{"type":"string","description":"Address at this point, falling back to the object's last known address.","uniqueKey":"result.items.[INDEX].address","typeLabel":"string"}},"uniqueKey":"result.items.[INDEX]","typeLabel":"object"},"isRequired":true,"uniqueKey":"result","typeLabel":"object[]"}},"uniqueKey":"","typeLabel":"object"},"examples":{"Example":{"title":"Example","value":{"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":"2023-11-07T05:31:56Z","time_device":"2023-11-07T05:31:56Z","engine_hours":123,"odometer":123,"mileage":123,"address":"\u003cstring>"}]}}},"exampleType":"generated"}},"exampleType":"generated"},"d495f133-0f0b-468e-860d-482c58b6b9f7":{"description":"Validation failed, request IDs are invalid, or the daily per-object API usage quota was reached. Refer to the endpoint parameter descriptions for PUBLIC.400_001 through PUBLIC.400_005.","content":{"application/json":{"schema":{"type":"object","description":"Standard public API error envelope.","required":["statusCode","errorCode","message","timestamp"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"errorCode":{"type":"string","description":"Machine-readable error code. Public-specific codes use the `PUBLIC.*` prefix. Uncoded HTTP exceptions default to `ERR999`.","example":"PUBLIC.400_001","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","description":"Localized human-readable message.","example":"Enter From Time, because is required.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Error time in ISO 8601 UTC.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":400,"errorCode":"PUBLIC.400_001","message":"Validation error message","timestamp":"2026-05-17T01:00:00.000Z"},"examples":{"Example":{"title":"Example","value":{"statusCode":400,"errorCode":"PUBLIC.400_001","message":"Validation error message","timestamp":"2026-05-17T01:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"6cd5bf36-81c7-4b29-a4a9-f3c7be38a6e4":{"description":"API key is missing, invalid, or expired.","content":{"application/json":{"schema":{"type":"object","description":"Standard public API error envelope.","required":["statusCode","errorCode","message","timestamp"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"errorCode":{"type":"string","description":"Machine-readable error code. Public-specific codes use the `PUBLIC.*` prefix. Uncoded HTTP exceptions default to `ERR999`.","example":"PUBLIC.400_001","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","description":"Localized human-readable message.","example":"Enter From Time, because is required.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Error time in ISO 8601 UTC.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":401,"errorCode":"ERR999","message":"Unauthorized","timestamp":"2026-05-17T01:00:00.000Z"},"examples":{"Example":{"title":"Example","value":{"statusCode":401,"errorCode":"ERR999","message":"Unauthorized","timestamp":"2026-05-17T01:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"e6b4bdd9-3b27-4e62-b0bb-f6dfe569d582":{"description":"Organization subscription is inactive or suspended.","content":{"application/json":{"schema":{"type":"object","description":"Standard public API error envelope.","required":["statusCode","errorCode","message","timestamp"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"errorCode":{"type":"string","description":"Machine-readable error code. Public-specific codes use the `PUBLIC.*` prefix. Uncoded HTTP exceptions default to `ERR999`.","example":"PUBLIC.400_001","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","description":"Localized human-readable message.","example":"Enter From Time, because is required.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Error time in ISO 8601 UTC.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":403,"errorCode":"SUBSCRIPTION.403_002","message":"Your subscription is suspended. Please contact your Admin.","timestamp":"2026-05-17T01:00:00.000Z"},"examples":{"Example":{"title":"Example","value":{"statusCode":403,"errorCode":"SUBSCRIPTION.403_002","message":"Your subscription is suspended. Please contact your Admin.","timestamp":"2026-05-17T01:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"7167f938-b4f0-4c10-a2af-c665ff7a7e4d":{"description":"The object ID does not exist in the authenticated organization.","content":{"application/json":{"schema":{"type":"object","description":"Standard public API error envelope.","required":["statusCode","errorCode","message","timestamp"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"errorCode":{"type":"string","description":"Machine-readable error code. Public-specific codes use the `PUBLIC.*` prefix. Uncoded HTTP exceptions default to `ERR999`.","example":"PUBLIC.400_001","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","description":"Localized human-readable message.","example":"Enter From Time, because is required.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Error time in ISO 8601 UTC.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":404,"errorCode":"PUBLIC.404_001","message":"Object not found.","timestamp":"2026-05-17T01:00:00.000Z"},"examples":{"Example":{"title":"Example","value":{"statusCode":404,"errorCode":"PUBLIC.404_001","message":"Object not found.","timestamp":"2026-05-17T01:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"},"3b711654-de4e-4144-9a85-679598db6880":{"description":"Organization exceeded 10 requests in a 10-second window.","content":{"application/json":{"schema":{"type":"object","description":"Standard public API error envelope.","required":["statusCode","errorCode","message","timestamp"],"properties":{"statusCode":{"type":"integer","description":"HTTP status code.","example":400,"isRequired":true,"uniqueKey":"statusCode","typeLabel":"integer"},"errorCode":{"type":"string","description":"Machine-readable error code. Public-specific codes use the `PUBLIC.*` prefix. Uncoded HTTP exceptions default to `ERR999`.","example":"PUBLIC.400_001","isRequired":true,"uniqueKey":"errorCode","typeLabel":"string"},"message":{"type":"string","description":"Localized human-readable message.","example":"Enter From Time, because is required.","isRequired":true,"uniqueKey":"message","typeLabel":"string"},"timestamp":{"type":"string","format":"date-time","description":"Error time in ISO 8601 UTC.","isRequired":true,"uniqueKey":"timestamp","typeLabel":"string\u003cdate-time>"}},"uniqueKey":"","typeLabel":"object"},"example":{"statusCode":429,"errorCode":"ERR999","message":"ThrottlerException: Too Many Requests","timestamp":"2026-05-17T01:00:00.000Z"},"examples":{"Example":{"title":"Example","value":{"statusCode":429,"errorCode":"ERR999","message":"ThrottlerException: Too Many Requests","timestamp":"2026-05-17T01:00:00.000Z"}}},"exampleType":"examples"}},"exampleType":"examples"}},"security":{"66731604-e134-494e-a5f8-aee6e12ee006":{"ApiKeyAuth":{"type":"apiKey","in":"header","name":"x-api-key","description":"Organization API key issued from Jitra (Organization → API Key).","scopes":[]}},"b320dd9c-5424-4a12-b7e0-5c5d8423562e":{"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Same organization API key sent as `Authorization: Bearer \u003capi_key>`.","scopes":[]}}},"servers":{"e238673c-bfd4-4a14-8e29-539a4974a3d8":{"url":"https://api.jitra.app/public/v1","description":"Production"},"ec7d20b4-50b0-4ca9-8699-4feaf628a552":{"url":"{scheme}://{host}:{port}/public/v1","description":"Local or custom environment","variables":{"scheme":{"default":"http","enum":["http","https"]},"host":{"default":"localhost"},"port":{"default":"3000","description":"Value of PUBLIC_APP_PORT"}}}},"processedSecurityOptions":[{"schemes":[{"scheme":{"type":"apiKey","in":"header","name":"x-api-key","description":"Organization API key issued from Jitra (Organization → API Key).","scopes":[]},"schema":{"title":"x-api-key","type":"string","description":"Organization API key issued from Jitra (Organization → API Key).","isRequired":true,"typeLabel":"string","deprecated":false},"schemeName":"ApiKeyAuth","name":"x-api-key"}],"title":"ApiKeyAuth"},{"schemes":[{"scheme":{"type":"http","scheme":"bearer","bearerFormat":"API Key","description":"Same organization API key sent as `Authorization: Bearer \u003capi_key>`.","scopes":[]},"schema":{"title":"Bearer Auth","type":"string","isRequired":true,"description":"Same organization API key sent as `Authorization: Bearer \u003capi_key>`.","format":"bearer","typeLabel":"string\u003cbearer>","deprecated":false},"schemeName":"BearerAuth","name":"Authorization"}],"title":"BearerAuth"}]},"originalFileLocation":"openapi.json"},"subdomain":"jitra","siteName":"Jitra Documentation","title":"Read Object Positions - Jitra Documentation","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{"en":{"href":"/en/api-reference/endpoints/read-object-positions","matchLevel":0},"id":{"href":"/id/api-reference/endpoints/read-object-positions","matchLevel":1}}},"lastModified":"2026-09-01T13:37:35.170Z","originalFileLocation":"en/api-reference/endpoints/read-object-positions.mdx","locale":"en"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"light\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Returns historical positions for one Object within a required date or datetime range.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Jitra Documentation\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Read Object Positions - Jitra Documentation\">\u003cmeta data-mint-head property=\"og:description\" content=\"Returns historical positions for one Object within a required date or datetime range.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Jitra Documentation\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://jitra.mintlify.site/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Read+Object+Positions\u0026amp;description=Returns+historical+positions+for+one+Object+within+a+required+date+or+datetime+range.\u0026amp;theme=fe56fff3c82b10b994c1b281\u0026amp;signature=04a9ab0299cb7edd4babdc11864ef4a1d416593f68d17d2a2ae7f9d6f315129e\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Read Object Positions - Jitra Documentation\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Returns historical positions for one Object within a required date or datetime range.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://jitra.mintlify.site/_mintlify/api/og/v2?division=Endpoints\u0026amp;title=Read+Object+Positions\u0026amp;description=Returns+historical+positions+for+one+Object+within+a+required+date+or+datetime+range.\u0026amp;theme=fe56fff3c82b10b994c1b281\u0026amp;signature=04a9ab0299cb7edd4babdc11864ef4a1d416593f68d17d2a2ae7f9d6f315129e\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/jitra/Y3gVgzR07bSGpRm9/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Jitra Documentation\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#4054a4\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/en/api-reference/endpoints/read-object-positions.md\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"en\" href=\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"id\" href=\"https://docs.jitra.app/id/api-reference/endpoints/read-object-positions\">\u003clink data-mint-head rel=\"alternate\" hreflang=\"x-default\" href=\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.jitra.app/#organization\",\"name\":\"Jitra Documentation\",\"url\":\"https://docs.jitra.app\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/jitra/V_6KYV2NQaTyFxel/images/logo-full.png?fit=max\u0026auto=format\u0026n=V_6KYV2NQaTyFxel\u0026q=85\u0026s=0112bf9bc16ea5f2008c91173621c73e\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.jitra.app#website\",\"name\":\"Jitra Documentation\",\"url\":\"https://docs.jitra.app\",\"publisher\":{\"@id\":\"https://docs.jitra.app/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions#webpage\",\"url\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions\",\"name\":\"Read Object Positions\",\"description\":\"Returns historical positions for one Object within a required date or datetime range.\",\"dateModified\":\"2026-09-01T13:37:35.170Z\",\"isPartOf\":{\"@id\":\"https://docs.jitra.app#website\"},\"breadcrumb\":{\"@id\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Endpoints\",\"item\":\"https://docs.jitra.app/en/api-reference/endpoints/read-objects\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Read Object Positions\",\"item\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions\"}]},{\"@type\":[\"TechArticle\",\"APIReference\"],\"@id\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions#apireference\",\"headline\":\"Read Object Positions\",\"name\":\"Read Object Positions\",\"description\":\"Returns historical positions for one Object within a required date or datetime range.\",\"url\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions\",\"mainEntityOfPage\":{\"@id\":\"https://docs.jitra.app/en/api-reference/endpoints/read-object-positions#webpage\"},\"dateModified\":\"2026-09-01T13:37:35.170Z\",\"publisher\":{\"@id\":\"https://docs.jitra.app/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.jitra.app#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Jitra Documentation\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Jitra Documentation\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/en/api-reference/endpoints/read-object-positions.md","siteName":"Jitra Documentation","nav":{"global":null,"languages":[{"language":"en","default":true,"tabs":[{"tab":"Guides","pages":[{"title":"Guides","href":"/en/introduction/what-is-jitra"}]},{"tab":"API Reference","groups":[{"group":"Get Started","pages":[{"title":"Jitra Public API","sidebarTitle":"Introduction","href":"/en/api-reference/introduction"},{"title":"Authentication","sidebarTitle":"Authentication","href":"/en/api-reference/authentication"}]},{"group":"Endpoints","pages":[{"title":"Read Objects","sidebarTitle":"Read Objects","openapi":"openapi.json GET /objects","href":"/en/api-reference/endpoints/read-objects"},{"title":"Read One Object","sidebarTitle":"Read One Object","description":"Returns one Object with detailed location, telemetry, metadata, and latest real-time values when available.","openapi":"openapi.json GET /objects/{id}","href":"/en/api-reference/endpoints/read-object"},{"title":"Read Object Positions","sidebarTitle":"Object Positions","openapi":"openapi.json GET /objects/{id}/positions","href":"/en/api-reference/endpoints/read-object-positions"},{"title":"Read Latest Positions","sidebarTitle":"Latest Positions","description":"Returns the latest real-time position snapshot for every requested Object ID.","openapi":"openapi.json GET /positions/latest","href":"/en/api-reference/endpoints/read-latest-positions"},{"title":"Read Geofences","sidebarTitle":"Geofences","openapi":"openapi.json GET /geofences","href":"/en/api-reference/endpoints/read-geofences"},{"title":"Read Sites","sidebarTitle":"Sites","openapi":"openapi.json GET /sites","href":"/en/api-reference/endpoints/read-sites"},{"title":"Read Routes","sidebarTitle":"Routes","openapi":"openapi.json GET /routes","href":"/en/api-reference/endpoints/read-routes"}]}]},{"tab":"Changelog","pages":[{"title":"Changelog","href":"/en/changelog/v2-8-0"}]}]},{"language":"id","pages":[{"title":"id","href":"/id/api-reference/endpoints/read-object-positions"}]}]},"basePath":"","title":"Read Object Positions - Jitra Documentation","buildId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","deploymentId":"dpl_G2Qd45vZZ7MkBiGF9yYx8ZsbbKXX","dynamics":["c2aa737661","2b790eda92","b0f84f53ff","a9bb46feb3"],"chunks":["OpenApiReferenceProvider-NXj-Rqjv.js","utils-m0thOP-_.js","cloneDeep-izs3Hzxb.js","_Uint8Array-BVIqJ90l.js","isObjectLike-C8vmzPEN.js","isArray-Dcu1dQ5t.js","utils-D13EKcfm.js","toString-BX-iyh8G.js","isSymbol-CSH9U2Gm.js","addUniqueKeysToSchema--XTdfsEb.js","snippetPresets-D3s4lmAH.js","style-to-object-BY3JEAdk.js","v4-DIgz8zy6.js","conditional-requirements-CFM0id0Q.js","ApiExamples-ChURybxL.js","isEqual-BfaiBbcl.js","usePlaygroundInputsStore-DL8CiXq2.js","shallow-DI2-YB2E.js","getApiPlaygroundDisplay-DxbW7b_y.js","CodeSnippet-CiNYS0pP.js","CodeSnippets-BT87bThu.js","Page-DSpdRuhM.js","getPastedJson-F_g_IrFQ.js","icon-CCIG5BAs.js","MethodPill-DY3E0jwx.js","DuplicateIcon-BN88xnEg.js","createIcon-VCCc5HO5.js","DynamicMarkdown-CaSwclgK.js","SectionHeading-DXV8nWhc.js","axios-vUo_bRtp.js","Markdown-CV32Re6G.js","clsx-5ydLOnhV.js","lib-DuNMoZ05.js","lib-B8HbPgcC.js","html-void-elements-mCSPHezU.js","dist-pFDdfjRe.js","katex-YMM-FMeD.js","marked.esm-CZWythHk.js","AssistantPageLink-BUGO5bPJ.js"]}