API Reference

Complete documentation for the Lattis - Nexus API. Build powerful integrations with our platform using our well-documented endpoints.

Authentication

All API requests require authentication using API keys. Include your API key in the Authorization header of each request.

cURL
curl -X GET "https://api.lattis-nexus.com/v2/fleet/vehicles" \
  -H "Authorization: Bearer your_api_key" \
  -H "Content-Type: application/json"
Python
from lattis_nexus import Client

client = Client(api_key='your_api_key')
vehicles = client.fleet.get_vehicles()
JavaScript
import { LattisNexusClient } from '@lattis-nexus/sdk';

const client = new LattisNexusClient({
  apiKey: 'your_api_key'
});

const vehicles = await client.fleet.getVehicles();

Endpoints

Fleet Management

Manage your vehicle fleet

GET
/v2/fleet/vehicles

List all vehicles in the fleet

Parameters

NameTypeDescription
statusstringFilter by vehicle status
limitnumberMaximum number of results
offsetnumberPagination offset

Response

JSON
{
  "vehicles": [
    {
      "id": "v123",
      "status": "active",
      "location": {
        "lat": 37.7749,
        "lng": -122.4194
      },
      "battery": 85,
      "lastUpdate": "2024-01-15T08:30:00Z"
    }
  ],
  "total": 150,
  "limit": 10,
  "offset": 0
}
POST
/v2/fleet/vehicles

Add a new vehicle to the fleet

Parameters

NameTypeDescription
vehicleIdstringUnique vehicle identifier
typestringVehicle type
configurationobjectVehicle configuration

Request Body

JSON
{
  "vehicleId": "v123",
  "type": "autonomous_car",
  "configuration": {
    "sensors": ["lidar", "camera"],
    "capacity": 4,
    "autonomyLevel": 4
  }
}

Response

JSON
{
  "id": "v123",
  "status": "registered",
  "createdAt": "2024-01-15T08:30:00Z"
}

Telemetry

Real-time vehicle telemetry data

GET
/v2/telemetry/{vehicleId}

Get latest telemetry for a vehicle

Parameters

NameTypeDescription
vehicleIdstringVehicle identifier
fieldsstringComma-separated list of fields

Response

JSON
{
  "vehicleId": "v123",
  "timestamp": "2024-01-15T08:30:00Z",
  "data": {
    "speed": 25.5,
    "heading": 180,
    "battery": 85,
    "temperature": 72
  }
}
POST
/v2/telemetry/{vehicleId}/stream

Subscribe to real-time telemetry stream

Parameters

NameTypeDescription
vehicleIdstringVehicle identifier
eventsarrayList of event types to subscribe to

Request Body

JSON
{
  "events": ["location", "battery", "diagnostics"],
  "interval": 1000
}

Response

JSON
{
  "streamId": "stream_123",
  "status": "connected",
  "subscriptions": ["location", "battery", "diagnostics"]
}