# Graviton Geo V1 - [Graviton Geo V2 API](https://api-doc.track.graviton.ma/index.md): Connect your fleet data to the tools your business uses. - [Quickstart](https://api-doc.track.graviton.ma/quickstart.md): Authenticate, list your fleet, and retrieve a vehicle position. - [Authentication and access](https://api-doc.track.graviton.ma/authentication.md): Authenticate with scoped API tokens, manage token permissions, and understand access and permission errors. - [Responses, errors, and limits](https://api-doc.track.graviton.ma/responses-and-limits.md): Handle JSON envelopes, pagination, throttling, and failures. - [Tracking and reports](https://api-doc.track.graviton.ma/tracking-and-reports.md): Retrieve history and produce fleet reports. - [Device commands](https://api-doc.track.graviton.ma/commands.md): Understand command queueing and device execution. - [API information](https://api-doc.track.graviton.ma/api-reference/system/api-information.md) - [Check API health](https://api-doc.track.graviton.ma/api-reference/system/check-api-health.md) - [Authenticated account](https://api-doc.track.graviton.ma/api-reference/account/authenticated-account.md) - [Authenticated account permissions](https://api-doc.track.graviton.ma/api-reference/account/authenticated-account-permissions.md) - [Get your login history](https://api-doc.track.graviton.ma/api-reference/account/get-your-login-history.md): Returns login history for your own account. - [Authenticated account objects](https://api-doc.track.graviton.ma/api-reference/fleet/authenticated-account-objects.md) - [List accessible objects](https://api-doc.track.graviton.ma/api-reference/fleet/list-accessible-objects.md) - [Create an object](https://api-doc.track.graviton.ma/api-reference/fleet/create-an-object.md): Creates an object in your account. Requires object-add permission and an available account object slot. - [Update objects in a batch](https://api-doc.track.graviton.ma/api-reference/fleet/update-objects-in-a-batch.md): Each object may receive different supported changes. The complete request and access scope are validated before any update; duplicate IMEIs and unsupported fields are rejected. Requires write access. A read-only account cannot perform this operation. Requires object-edit permission. - [Read objects in a batch](https://api-doc.track.graviton.ma/api-reference/fleet/read-objects-in-a-batch.md): Reads up to 100 exact object identifiers. Returns accessible objects with their assignments, unavailable identifiers, and authorization failures. This operation does not modify objects. - [Get an accessible object](https://api-doc.track.graviton.ma/api-reference/fleet/get-an-accessible-object.md) - [Safely deactivate an object](https://api-doc.track.graviton.ma/api-reference/fleet/safely-deactivate-an-object.md): Requires write access. A read-only account cannot perform this operation. Requires object-edit permission. - [Update an object](https://api-doc.track.graviton.ma/api-reference/fleet/update-an-object.md): Updates supported current object fields. dt_server and dt_tracker accept UTC YYYY-MM-DD HH:MM:SS or RFC3339 with an explicit timezone and are normalized to UTC. Historical tracker rows are not changed. Requires write access. A read-only account cannot perform this operation. Requires object-edit per… - [Set active state in a batch](https://api-doc.track.graviton.ma/api-reference/fleet/set-active-state-in-a-batch.md): Atomically changes the active state of up to 100 object entries. Duplicate IMEIs are processed once. Every target must be accessible and object-edit permission is required. Expiration dates are preserved. - [Activate an object](https://api-doc.track.graviton.ma/api-reference/fleet/activate-an-object.md): Requires write access. A read-only account cannot perform this operation. Requires object-edit permission. - [Deactivate an object](https://api-doc.track.graviton.ma/api-reference/fleet/deactivate-an-object.md): Requires write access. A read-only account cannot perform this operation. Requires object-edit permission. - [Assign driver, group, or trailer](https://api-doc.track.graviton.ma/api-reference/fleet/assign-driver-group-or-trailer.md): Requires write access. A read-only account cannot perform this operation. - [Remove driver, group, or trailer assignment](https://api-doc.track.graviton.ma/api-reference/fleet/remove-driver-group-or-trailer-assignment.md): Requires write access. A read-only account cannot perform this operation. Requires object-edit permission. - [Get latest position](https://api-doc.track.graviton.ma/api-reference/tracking/get-latest-position.md) - [Get object status](https://api-doc.track.graviton.ma/api-reference/tracking/get-object-status.md) - [Get current engine hours](https://api-doc.track.graviton.ma/api-reference/tracking/get-current-engine-hours.md) - [List object event history](https://api-doc.track.graviton.ma/api-reference/tracking/list-object-event-history.md) - [List object sensors](https://api-doc.track.graviton.ma/api-reference/tracking/list-object-sensors.md) - [List object services](https://api-doc.track.graviton.ma/api-reference/tracking/list-object-services.md) - [Get paginated location history](https://api-doc.track.graviton.ma/api-reference/tracking/get-paginated-location-history.md): Requires the history permission for subaccounts. Supply from and to with explicit timezones; the interval must not exceed 93 days. - [Get route and distance](https://api-doc.track.graviton.ma/api-reference/tracking/get-route-and-distance.md): Requires the history permission for subaccounts. Supply from and to with explicit timezones; the interval must not exceed 93 days. - [Get stop segments](https://api-doc.track.graviton.ma/api-reference/tracking/get-stop-segments.md): Requires the history permission for subaccounts. Supply from and to with explicit timezones; the interval must not exceed 93 days. Calculation uses at most 10,000 points. Stops use speed below 1; driving uses speed of 1 or greater. - [Get driving segments](https://api-doc.track.graviton.ma/api-reference/tracking/get-driving-segments.md): Requires the history permission for subaccounts. Supply from and to with explicit timezones; the interval must not exceed 93 days. Calculation uses at most 10,000 points. Stops use speed below 1; driving uses speed of 1 or greater. - [Get calculated mileage](https://api-doc.track.graviton.ma/api-reference/tracking/get-calculated-mileage.md): Requires the history permission for subaccounts. Supply from and to with explicit timezones; the interval must not exceed 93 days. - [List object commands](https://api-doc.track.graviton.ma/api-reference/commands/list-object-commands.md) - [Queue a GPRS object command](https://api-doc.track.graviton.ma/api-reference/commands/queue-a-gprs-object-command.md): Queues a device-specific GPRS command. SMS dispatch is unavailable. Requires write access. Poll the command status endpoint to inspect the result; acceptance is not device execution. - [Get command status](https://api-doc.track.graviton.ma/api-reference/commands/get-command-status.md) - [Queue an immobilization command](https://api-doc.track.graviton.ma/api-reference/commands/queue-an-immobilization-command.md): Queues a command that can affect the physical vehicle. Requires write access and the stop_engine permission for subaccounts. Confirm the device configuration and safe operating conditions before use. A matching account template or supported protocol command may be selected; otherwise supply a device… - [Queue a remobilization command](https://api-doc.track.graviton.ma/api-reference/commands/queue-a-remobilization-command.md): Queues a command that can affect the physical vehicle. Requires write access and the stop_engine permission for subaccounts. Confirm the device configuration and safe operating conditions before use. A matching account template or supported protocol command may be selected; otherwise supply a device… - [List markers](https://api-doc.track.graviton.ma/api-reference/places/list-markers.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. - [Create a marker](https://api-doc.track.graviton.ma/api-reference/places/create-a-marker.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [Get a marker](https://api-doc.track.graviton.ma/api-reference/places/get-a-marker.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. - [Delete a marker](https://api-doc.track.graviton.ma/api-reference/places/delete-a-marker.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [Update a marker](https://api-doc.track.graviton.ma/api-reference/places/update-a-marker.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [List zones](https://api-doc.track.graviton.ma/api-reference/places/list-zones.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. - [Create a zone](https://api-doc.track.graviton.ma/api-reference/places/create-a-zone.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [Get a zone](https://api-doc.track.graviton.ma/api-reference/places/get-a-zone.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. - [Delete a zone](https://api-doc.track.graviton.ma/api-reference/places/delete-a-zone.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [Update a zone](https://api-doc.track.graviton.ma/api-reference/places/update-a-zone.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [List routes](https://api-doc.track.graviton.ma/api-reference/places/list-routes.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. - [Create a route](https://api-doc.track.graviton.ma/api-reference/places/create-a-route.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [Get a route](https://api-doc.track.graviton.ma/api-reference/places/get-a-route.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. - [Delete a route](https://api-doc.track.graviton.ma/api-reference/places/delete-a-route.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [Update a route](https://api-doc.track.graviton.ma/api-reference/places/update-a-route.md): Works with resources accessible to your account. Subaccounts need the `places_control` permission. Requires write access. A read-only account cannot perform this operation. - [List drivers](https://api-doc.track.graviton.ma/api-reference/people-and-groups/list-drivers.md): Works with resources accessible to your account. - [Create a driver](https://api-doc.track.graviton.ma/api-reference/people-and-groups/create-a-driver.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a driver](https://api-doc.track.graviton.ma/api-reference/people-and-groups/get-a-driver.md): Works with resources accessible to your account. - [Delete a driver](https://api-doc.track.graviton.ma/api-reference/people-and-groups/delete-a-driver.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a driver](https://api-doc.track.graviton.ma/api-reference/people-and-groups/update-a-driver.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [List passengers](https://api-doc.track.graviton.ma/api-reference/people-and-groups/list-passengers.md): Works with resources accessible to your account. - [Create a passenger](https://api-doc.track.graviton.ma/api-reference/people-and-groups/create-a-passenger.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a passenger](https://api-doc.track.graviton.ma/api-reference/people-and-groups/get-a-passenger.md): Works with resources accessible to your account. - [Delete a passenger](https://api-doc.track.graviton.ma/api-reference/people-and-groups/delete-a-passenger.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a passenger](https://api-doc.track.graviton.ma/api-reference/people-and-groups/update-a-passenger.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [List trailers](https://api-doc.track.graviton.ma/api-reference/people-and-groups/list-trailers.md): Works with resources accessible to your account. - [Create a trailer](https://api-doc.track.graviton.ma/api-reference/people-and-groups/create-a-trailer.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a trailer](https://api-doc.track.graviton.ma/api-reference/people-and-groups/get-a-trailer.md): Works with resources accessible to your account. - [Delete a trailer](https://api-doc.track.graviton.ma/api-reference/people-and-groups/delete-a-trailer.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a trailer](https://api-doc.track.graviton.ma/api-reference/people-and-groups/update-a-trailer.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [List groups](https://api-doc.track.graviton.ma/api-reference/people-and-groups/list-groups.md): Works with resources accessible to your account. - [Create a group](https://api-doc.track.graviton.ma/api-reference/people-and-groups/create-a-group.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a group](https://api-doc.track.graviton.ma/api-reference/people-and-groups/get-a-group.md): Works with resources accessible to your account. - [Delete a group](https://api-doc.track.graviton.ma/api-reference/people-and-groups/delete-a-group.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a group](https://api-doc.track.graviton.ma/api-reference/people-and-groups/update-a-group.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [List events](https://api-doc.track.graviton.ma/api-reference/events/list-events.md): Works with resources accessible to your account. Subaccounts need the `event_notifications` permission. - [Create a event rule](https://api-doc.track.graviton.ma/api-reference/events/create-a-event-rule.md): Works with resources accessible to your account. Subaccounts need the `event_notifications` permission. Requires write access. A read-only account cannot perform this operation. - [Get a event rule](https://api-doc.track.graviton.ma/api-reference/events/get-a-event-rule.md): Works with resources accessible to your account. Subaccounts need the `event_notifications` permission. - [Delete a event rule](https://api-doc.track.graviton.ma/api-reference/events/delete-a-event-rule.md): Works with resources accessible to your account. Subaccounts need the `event_notifications` permission. Requires write access. A read-only account cannot perform this operation. - [Update a event rule](https://api-doc.track.graviton.ma/api-reference/events/update-a-event-rule.md): Works with resources accessible to your account. Subaccounts need the `event_notifications` permission. Requires write access. A read-only account cannot perform this operation. - [List RFID events](https://api-doc.track.graviton.ma/api-reference/events/list-rfid-events.md) - [Get assignment logbook](https://api-doc.track.graviton.ma/api-reference/events/get-assignment-logbook.md) - [List services](https://api-doc.track.graviton.ma/api-reference/maintenance/list-services.md): Works with resources accessible to your account. - [Create a maintenance service](https://api-doc.track.graviton.ma/api-reference/maintenance/create-a-maintenance-service.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a maintenance service](https://api-doc.track.graviton.ma/api-reference/maintenance/get-a-maintenance-service.md): Works with resources accessible to your account. - [Delete a maintenance service](https://api-doc.track.graviton.ma/api-reference/maintenance/delete-a-maintenance-service.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a maintenance service](https://api-doc.track.graviton.ma/api-reference/maintenance/update-a-maintenance-service.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [List maintenance due](https://api-doc.track.graviton.ma/api-reference/maintenance/list-maintenance-due.md): Returns up to 500 due maintenance records for your fleet, newest service first. - [List sensors](https://api-doc.track.graviton.ma/api-reference/sensors/list-sensors.md): Works with resources accessible to your account. - [Create a sensor](https://api-doc.track.graviton.ma/api-reference/sensors/create-a-sensor.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a sensor](https://api-doc.track.graviton.ma/api-reference/sensors/get-a-sensor.md): Works with resources accessible to your account. - [Delete a sensor](https://api-doc.track.graviton.ma/api-reference/sensors/delete-a-sensor.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a sensor](https://api-doc.track.graviton.ma/api-reference/sensors/update-a-sensor.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [List reports](https://api-doc.track.graviton.ma/api-reference/reports/list-reports.md): Works with resources accessible to your account. Subaccounts need the `reports` permission. - [Create a report definition](https://api-doc.track.graviton.ma/api-reference/reports/create-a-report-definition.md): Works with resources accessible to your account. Subaccounts need the `reports` permission. Requires write access. A read-only account cannot perform this operation. - [Get a report definition](https://api-doc.track.graviton.ma/api-reference/reports/get-a-report-definition.md): Works with resources accessible to your account. Subaccounts need the `reports` permission. - [Delete a report definition](https://api-doc.track.graviton.ma/api-reference/reports/delete-a-report-definition.md): Works with resources accessible to your account. Subaccounts need the `reports` permission. Requires write access. A read-only account cannot perform this operation. - [Update a report definition](https://api-doc.track.graviton.ma/api-reference/reports/update-a-report-definition.md): Works with resources accessible to your account. Subaccounts need the `reports` permission. Requires write access. A read-only account cannot perform this operation. - [Generate a read-only report](https://api-doc.track.graviton.ma/api-reference/reports/generate-a-read-only-report.md): Generates a read-only report with at most 10,000 rows. Events and RFID reports require from and to, with an interval of at most 93 days. Requires the reports permission for subaccounts. - [Generate and download a report as CSV](https://api-doc.track.graviton.ma/api-reference/reports/generate-and-download-a-report-as-csv.md) - [List templates](https://api-doc.track.graviton.ma/api-reference/templates/list-templates.md): Works with resources accessible to your account. - [Create a message template](https://api-doc.track.graviton.ma/api-reference/templates/create-a-message-template.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a message template](https://api-doc.track.graviton.ma/api-reference/templates/get-a-message-template.md): Works with resources accessible to your account. - [Delete a message template](https://api-doc.track.graviton.ma/api-reference/templates/delete-a-message-template.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a message template](https://api-doc.track.graviton.ma/api-reference/templates/update-a-message-template.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [List command templates](https://api-doc.track.graviton.ma/api-reference/templates/list-command-templates.md): Works with resources accessible to your account. - [Create a command template](https://api-doc.track.graviton.ma/api-reference/templates/create-a-command-template.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Get a command template](https://api-doc.track.graviton.ma/api-reference/templates/get-a-command-template.md): Works with resources accessible to your account. - [Delete a command template](https://api-doc.track.graviton.ma/api-reference/templates/delete-a-command-template.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. - [Update a command template](https://api-doc.track.graviton.ma/api-reference/templates/update-a-command-template.md): Works with resources accessible to your account. Requires write access. A read-only account cannot perform this operation. ## OpenAPI Specs - [openapi](/openapi.json) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.