For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
GuidesWhite-labelAPI Reference
GuidesWhite-labelAPI Reference
  • Panic API Reference
      • POSTLink a device to a customer
      • PUTUpdate a linked device
      • DELUnlink a device
      • POSTSend a device event
    • Errors & status codes
LogoLogo
Panic API ReferenceIoT Devices

Send a device event

POST
/panic-api/v2/deviceEvent
POST
/panic-api/v2/deviceEvent
$curl -X POST https://staging-panic.aura.services/panic-api/v2/deviceEvent \
>     -H "Authorization: Bearer <token>" \
>     -H "Content-Type: application/json" \
>     -d '{
>  "location": {
>    "latitude": -26.0919,
>    "longitude": 28.084,
>    "accuracy": 70
>  },
>  "device_id": 26217939,
>  "device_type_id": 5,
>  "message_type": 1
>}'
1{
2  "message": "Event successfully processed...",
3  "resolvedAuraEvent": {
4    "eventTypes": "NEW_CALLOUT",
5    "eventResponse": {
6      "calloutId": 992011,
7      "deviceId": 26217939
8    }
9  }
10}
Ingests a message from a registered IoT device. AURA applies the device's template (selected by `device_type_id`) to interpret the message and map it to an AURA action — raise a callout, update location, cancel a callout, or record a battery/health update. The accepted fields depend on the device template; see the Device & payment gateway guide for the mapping and more examples.
Was this page helpful?
Previous

Register a webhook

Next
Built with

Ingests a message from a registered IoT device. AURA applies the device’s template (selected by device_type_id) to interpret the message and map it to an AURA action — raise a callout, update location, cancel a callout, or record a battery/health update. The accepted fields depend on the device template; see the Device & payment gateway guide for the mapping and more examples.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Request

This endpoint expects an object.

Response

Event processed; returns the resolved AURA action.

messagestring
inputobject
Echo of the device message that was received.
resolvedAuraEventobject

Errors

400
Bad Request Error
401
Unauthorized Error