> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://developers.nukio.mx/nukio-api/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://developers.nukio.mx/_mcp/server.

# Overview

Welcome to the Nukio Asset Protection API.

This collection provides a broad set of requests for working with the Nukio API across authentication, users, devices, geozones, events, notifications, routes, commands, and reporting data.

It includes endpoints for:

* authenticating and obtaining access tokens
* creating, retrieving, updating, and deleting users and devices
* managing geozones and route-related data
* sending commands and feature updates to devices
* retrieving fleet, device, activation, and diagnostic data
* handling notifications, push registration, and message status

The collection is intended to support day-to-day API exploration, testing, and operational workflows using environment variables such as `{URL}`, `{token}`, and entity-specific identifiers.

# Nukio API

The Nukio API is designed around RESTful principles, providing a secure, predictable, and resource-oriented interface for integrating with the Nukio Asset Protection platform. Endpoints leverage standard HTTP methods and response codes to ensure consistency and ease of implementation across a wide range of applications and environments.

All request and response payloads are encoded in JSON unless otherwise specified.

## Response Structure

API responses follow a standardized format to simplify integration and error handling.

### Successful Responses

Successful requests return a `data` object containing the requested resource or collection of resources.

#### JavaScript

```javascript
{
  "data": []
}

```

#### Python

```python
{
  "data": []
}

```

#### Java

```java
{
  "data": []
}

```

#### cURL

```curl
{
  "data": []
}

```

#### Shell

```bash
{
  "data": []
}

```

### Error Responses

If a request cannot be processed or an internal error occurs, the API returns an `error` object describing the issue.

#### JavaScript

```javascript
{
  "error": {}
}

```

#### Python

```python
{
  "error": {}
}

```

#### Java

```java
{
  "error": {}
}

```

#### cURL

```curl
{
  "error": {}
}

```

#### Shell

```bash
{
  "error": {}
}

```

## Date and Time Format

All timestamps are represented as Unix Epoch values (UTC) expressed in seconds.

#### JavaScript

```javascript
{
  "timestamp": 1768920791
}

```

#### Python

```python
{
  "timestamp": 1768920791
}

```

#### Java

```java
{
  "timestamp": 1768920791
}

```

#### cURL

```curl
{
  "timestamp": 1768920791
}

```

#### Shell

```bash
{
  "timestamp": 1768920791
}

```

## Geographic Coordinates

Location data is represented using decimal degree coordinates.

* **Latitude** represents the north-south position on the Earth's surface and ranges from **-90** to **+90**.
* **Longitude** represents the east-west position on the Earth's surface and ranges from **-180** to **+180**.

Example:

#### JavaScript

```javascript
{
  "deviceLastValidLatitude": 28.5947658,
  "deviceLastValidLongitude": -100.5939765
}

```

#### Python

```python
{
  "deviceLastValidLatitude": 28.5947658,
  "deviceLastValidLongitude": -100.5939765
}

```

#### Java

```java
{
  "deviceLastValidLatitude": 28.5947658,
  "deviceLastValidLongitude": -100.5939765
}

```

#### cURL

```curl
{
  "deviceLastValidLatitude": 28.5947658,
  "deviceLastValidLongitude": -100.5939765
}

```

#### Shell

```bash
{
  "deviceLastValidLatitude": 28.5947658,
  "deviceLastValidLongitude": -100.5939765
}

```

## Authentication

Most endpoints require a valid authentication token issued by the Nukio platform. Tokens must be provided in the request according to the requirements specified for each endpoint.

## Disclaimer

This documentation is provided for integration and development purposes only. While every effort is made to ensure accuracy and completeness, the Nukio API may evolve over time. Endpoints, parameters, response structures, and authentication mechanisms are subject to change without prior notice as part of ongoing platform improvements. Developers are encouraged to validate integrations in a testing environment before deploying changes to production systems.

> Nukio API

## Docs

- [Overview](https://developers.nukio.mx/nukio-api/authentication.md)
- [Overview](https://developers.nukio.mx/nukio-api/device.md)
- [Overview](https://developers.nukio.mx/nukio-api/user.md)
- [Overview](https://developers.nukio.mx/nukio-api/geozone.md)
- [Overview](https://developers.nukio.mx/nukio-api/fleets.md)
- [Overview](https://developers.nukio.mx/nukio-api/notifications.md)
- [Overview](https://developers.nukio.mx/nukio-api/routes.md)
- [Overview](https://developers.nukio.mx/nukio-api/passengers.md)
- [Overview](https://developers.nukio.mx/nukio-api/account-status.md)
- [Overview](https://developers.nukio.mx/nukio-api/nukio-sdk.md)

## API Docs

- Nukio API > Authentication [TOKEN](https://developers.nukio.mx/nukio-api/authentication/token.md)
- Nukio API > Device [feature engineCutoff](https://developers.nukio.mx/nukio-api/device/feature-engine-cutoff.md)
- Nukio API > Device [createdevice](https://developers.nukio.mx/nukio-api/device/createdevice.md)
- Nukio API > Device [deletedevice](https://developers.nukio.mx/nukio-api/device/deletedevice.md)
- Nukio API > Device [updatedevice](https://developers.nukio.mx/nukio-api/device/updatedevice.md)
- Nukio API > Device [diagnosticall](https://developers.nukio.mx/nukio-api/device/diagnosticall.md)
- Nukio API > Device [getallDevices](https://developers.nukio.mx/nukio-api/device/getall-devices.md)
- Nukio API > Device [firmwareUpdate](https://developers.nukio.mx/nukio-api/device/firmware-update.md)
- Nukio API > Device [updateAddress](https://developers.nukio.mx/nukio-api/device/update-address.md)
- Nukio API > Device [getDevice](https://developers.nukio.mx/nukio-api/device/get-device.md)
- Nukio API > Device [latest](https://developers.nukio.mx/nukio-api/device/latest.md)
- Nukio API > Device [diagnostic](https://developers.nukio.mx/nukio-api/device/diagnostic.md)
- Nukio API > Device [lostVehicles](https://developers.nukio.mx/nukio-api/device/lost-vehicles.md)
- Nukio API > Device [send](https://developers.nukio.mx/nukio-api/device/send.md)
- Nukio API > Device [getDeviceActivations](https://developers.nukio.mx/nukio-api/device/get-device-activations.md)
- Nukio API > Device [createActivation](https://developers.nukio.mx/nukio-api/device/create-activation.md)
- Nukio API > Device [feature cargoAccess](https://developers.nukio.mx/nukio-api/device/feature-cargo-access.md)
- Nukio API > Device [deviceMetadata](https://developers.nukio.mx/nukio-api/device/device-metadata.md)
- Nukio API > Device [updatedevice cargoAccess](https://developers.nukio.mx/nukio-api/device/updatedevice-cargo-access.md)
- Nukio API > Device [updatedevice engineCutoff](https://developers.nukio.mx/nukio-api/device/updatedevice-engine-cutoff.md)
- Nukio API > Device [deviceData](https://developers.nukio.mx/nukio-api/device/device-data.md)
- Nukio API > Device [getDeviceActivations range](https://developers.nukio.mx/nukio-api/device/get-device-activations-range.md)
- Nukio API > Device [deviceData range](https://developers.nukio.mx/nukio-api/device/device-data-range.md)
- Nukio API > User [createUser](https://developers.nukio.mx/nukio-api/user/create-user.md)
- Nukio API > User [deleteUser](https://developers.nukio.mx/nukio-api/user/delete-user.md)
- Nukio API > User [updateUser](https://developers.nukio.mx/nukio-api/user/update-user.md)
- Nukio API > User [getUser](https://developers.nukio.mx/nukio-api/user/get-user.md)
- Nukio API > Geozone [getGeozones](https://developers.nukio.mx/nukio-api/geozone/get-geozones.md)
- Nukio API > Geozone [createGeozone](https://developers.nukio.mx/nukio-api/geozone/create-geozone.md)
- Nukio API > Geozone [deleteGeozone](https://developers.nukio.mx/nukio-api/geozone/delete-geozone.md)
- Nukio API > Geozone [updateGeozone](https://developers.nukio.mx/nukio-api/geozone/update-geozone.md)
- Nukio API > Geozone [getGeozone](https://developers.nukio.mx/nukio-api/geozone/get-geozone.md)
- Nukio API > Geozone [getGeozones range](https://developers.nukio.mx/nukio-api/geozone/get-geozones-range.md)
- Nukio API > Fleets [groups](https://developers.nukio.mx/nukio-api/fleets/groups.md)
- Nukio API > Fleets [activations](https://developers.nukio.mx/nukio-api/fleets/activations.md)
- Nukio API > Fleets [activations by time](https://developers.nukio.mx/nukio-api/fleets/activations-by-time.md)
- Nukio API > Fleets [fleetMetadata](https://developers.nukio.mx/nukio-api/fleets/fleet-metadata.md)
- Nukio API > Fleets [fleetData](https://developers.nukio.mx/nukio-api/fleets/fleet-data.md)
- Nukio API > Fleets [fleetData range](https://developers.nukio.mx/nukio-api/fleets/fleet-data-range.md)
- Nukio API > Notifications [checkaccount](https://developers.nukio.mx/nukio-api/notifications/checkaccount.md)
- Nukio API > Notifications [getMessages](https://developers.nukio.mx/nukio-api/notifications/get-messages.md)
- Nukio API > Notifications [setMessages](https://developers.nukio.mx/nukio-api/notifications/set-messages.md)
- Nukio API > Notifications [getAllPushNotifications](https://developers.nukio.mx/nukio-api/notifications/get-all-push-notifications.md)
- Nukio API > Notifications [unregister-push](https://developers.nukio.mx/nukio-api/notifications/unregister-push.md)
- Nukio API > Notifications [setViewed](https://developers.nukio.mx/nukio-api/notifications/set-viewed.md)
- Nukio API > Notifications [register-push](https://developers.nukio.mx/nukio-api/notifications/register-push.md)
- Nukio API > Notifications [getNotifications](https://developers.nukio.mx/nukio-api/notifications/get-notifications.md)
- Nukio API > Notifications [getDeviceNotifications](https://developers.nukio.mx/nukio-api/notifications/get-device-notifications.md)
- Nukio API > Routes [getRoutes](https://developers.nukio.mx/nukio-api/routes/get-routes.md)
- Nukio API > Routes [routeUpdate](https://developers.nukio.mx/nukio-api/routes/route-update.md)
- Nukio API > Passengers [passengerCount](https://developers.nukio.mx/nukio-api/passengers/passenger-count.md)
- Nukio API > Account Status [getMonitorMetadata](https://developers.nukio.mx/nukio-api/account-status/get-monitor-metadata.md)

## OpenAPI Specification

The raw OpenAPI 3.1 specification for this API is available at:
- [OpenAPI JSON](https://developers.nukio.mx/nukio-api/openapi.json)
- [OpenAPI YAML](https://developers.nukio.mx/nukio-api/openapi.yaml)