POST
/v2/telemetry
202 Accepted
Submit a single telemetry payload containing GPS data, signals, or device diagnostics for a single asset.
Authentication
Requests must be signed with SigV4a.
Service name: execute-api, region set: *.
Headers
| Header | Description | |
|---|---|---|
X-Provider-Key | aggregators only | The provider name assigned during onboarding (not an API key). Required only for provider aggregators submitting on behalf of multiple providers. Single-provider integrations have this injected automatically from the onboarded account. |
Content-Type | required | Must be application/json. |
Request Body
See Telemetry Payload for the full field reference.
Example Request — GPS
{
"payloadId": "550e8400-e29b-41d4-a716-446655440000",
"carrier": "AZNG",
"signalTimestamp": 1751989541000,
"assetIdentifier": { "id": "MY-VEHICLE-01", "type": "TRACTOR", "operator": "AZNG" },
"gps": {
"latitude": 47.6062,
"longitude": -122.3321,
"speed": 88.5,
"speedUnits": "KILOMETERS_PER_HOUR",
"heading": 270.0,
"inMotion": true
}
}Example Request — Signals
{
"payloadId": "661f9510-f3ac-42d5-b827-557766551111",
"carrier": "AZNG",
"signalTimestamp": 1751989541000,
"deviceIdentifier": { "id": "XIRGO-DEVICE-001", "manufacturer": "XIRGO", "model": "XT2460" },
"signals": [
{
"id": "770e8400-e29b-41d4-a716-446655440000",
"type": "OBD_LIFETIME_ODOMETER",
"value": "245000.5",
"valueUnit": "KILOMETERS",
"assetPart": "ENGINE"
},
{
"id": "880e8400-e29b-41d4-a716-446655440000",
"type": "OBD_TOTAL_ENGINE_TIME",
"value": "4320.0",
"valueUnit": "HOURS",
"assetPart": "ENGINE"
}
]
}Response — 202 Accepted
| Field | Type | Description |
|---|---|---|
requestId | string |
Unique request identifier for support investigations. |
Error Responses
| Status | Description |
|---|---|
400 | Validation failed. Check validationErrorDetails for field-level specifics. |
403 | Authentication failed. Verify your SigV4a signing and that requests are signed from your registered AWS account. |
500 | Internal error. Retry with exponential backoff. Retain data locally for back-filling. |