> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/qna/apis.md).

# APIs

- [WebSockets vs get\_states API for real-time tracking data](https://navixy.com/docs/qna/apis/websockets-vs-get_states-api-for-real-time-tracking-data.md): Use WebSockets for real-time GPS data streaming without polling overhead. Use get\_states only if WebSockets unavailable in your environment
- [API error codes and HTTP statuses](https://navixy.com/docs/qna/apis/api-error-codes-and-http-statuses.md): Find platform error codes with their HTTP status equivalents in the Error codes reference. Includes endpoint-specific error codes for detailed troubleshooting
- [Empty list in API response](https://navixy.com/docs/qna/apis/empty-list-in-api-response.md): Handle empty lists gracefully in your client code. Empty responses with success=true indicate no data for your query parameters
- [Batch geocoding support for search\_location](https://navixy.com/docs/qna/apis/batch-geocoding-support-for-search_location.md): Loop through coordinates in your code to call search\_location for each pair. Batch geocoding is not supported by the geocoder endpoint
- [Get tracker events history via API](https://navixy.com/docs/qna/apis/get-tracker-events-history-via-api.md): Retrieve tracker event history by calling unread events endpoints or filtering by event type codes and time period. Supports geofence, bracelet removal
- [Retrieve latest sensor readings for multiple trackers](https://navixy.com/docs/qna/apis/retrieve-latest-sensor-readings-for-multiple-trackers.md): Call batch\_list with a list of tracker IDs to retrieve latest sensor readings. Get all trackers first, then filter for those with data
- [Update tracker label via API](https://navixy.com/docs/qna/apis/update-tracker-label-via-api.md): Call tracker/settings/update with correct group\_id to update the label. Retrieve current group\_id via tracker/list to avoid moving tracker
- [Identify a usual / longest parking location via API](https://navixy.com/docs/qna/apis/identify-a-usual-longest-parking-location-via-api.md): Determine parking locations by calling track/list and computing gaps between trip times or analyzing daily end locations
- [Track when output control was changed via API](https://navixy.com/docs/qna/apis/track-when-output-control-was-changed-via-api.md): Query audit logs via user/audit/log/list to track output control changes, or create state change alerts and read notification history
- [API to retrieve videos from the platform](https://navixy.com/docs/qna/apis/api-to-retrieve-videos-from-the-platform.md): Request video recovery from Support for active, connected cameras. No public API exists because automation could overload the platform servers
- [User session hash vs admin panel hash vs API key](https://navixy.com/docs/qna/apis/user-session-hash-vs-admin-panel-hash-vs-api-key.md): Prefer API keys for User API authentication as they don't expire. Use admin panel session keys for Admin Panel API with caution
- [Get relevant telemetry in one API call (get\_state)](https://navixy.com/docs/qna/apis/get-relevant-telemetry-in-one-api-call-get_state.md): Call tracker/get\_state to retrieve GPS position, speed, connection status, battery, inputs, outputs, and other telemetry data
- [Using the Task Form Values API call](https://navixy.com/docs/qna/apis/using-the-task-form-values-api-call.md): Submit and update form values for active tasks via the API. Task must be assigned and form submitted; completed or delayed tasks prevent modifications


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://navixy.com/docs/qna/apis.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
