Reference
API reference
Every operation, parameter, response and schema of API v1, generated from the OpenAPI 3.1 contract.
This reference is generated on every deployment from the contract v1 (2026-09-24), so what you see here is exactly what the API accepts and returns. The examples point to the sandbox; in production only the address changes.
| Environment | Address |
|---|---|
| Production | https://api.safeonuba.com |
| Testing, with simulated watches | https://sandbox.api.safeonuba.com |
Would you rather have the contract to generate a client or import it into your tool? Download the OpenAPI 3.1.
Authentication
OAuth2 client_credentials: an opaque token valid for one hour.
Sites
The client’s sites and their zones.
Alerts
What has happened, and acknowledging or resolving it from the customer’s control room.
Evacuations
Status, headcount by status and by muster point, ruled-out points and who is missing.
Workers
Workers and watches.
Positions
Only those the privacy veil allows.
Events
Replay the events of the last 30 days.
Webhooks
Destinations and the format of what is sent to them.
Sandbox
Test scenarios with simulated watches, so you can integrate without watches. Only on sandbox.api.safeonuba.com.
Schemas
The contract’s 56 objects, field by field.