# API reference

> Every operation, parameter, response and schema of API v1, generated from the OpenAPI 3.1 contract.

Page: https://safeonuba.com/en/developers/reference · SafeOnuba API v1 (`api_version: "2026-09-24"`), in preview: the contract may change.

## Environments

| Environment | Address |
| --- | --- |
| Production | `https://api.safeonuba.com` |
| Testing, with simulated watches | `https://sandbox.api.safeonuba.com` |

OpenAPI 3.1 contract: https://safeonuba.com/en/developers/openapi.json

## [Authentication](https://safeonuba.com/en/developers/reference/authentication.md)

OAuth2 `client_credentials`: an opaque token valid for one hour.

- `POST /v1/oauth/token`: Request a token (client_credentials)

## [Sites](https://safeonuba.com/en/developers/reference/sites.md)

The client’s sites and their zones.

- `GET /v1/sites`: The client’s sites
- `GET /v1/sites/{id}/zones`: A site’s zones and muster points

## [Alerts](https://safeonuba.com/en/developers/reference/alerts.md)

What has happened, and acknowledging or resolving it from the customer’s control room.

- `GET /v1/alerts`: List alerts
- `GET /v1/alerts/{id}`: Alert detail
- `PUT /v1/alerts/{id}`: Acknowledge or resolve an alert

## [Evacuations](https://safeonuba.com/en/developers/reference/evacuations.md)

Status, headcount by status and by muster point, ruled-out points and who is missing.

- `GET /v1/musters`: List evacuations
- `GET /v1/musters/{id}`: Status and headcount of an evacuation
- `GET /v1/musters/{id}/missing`: Who is missing

## [Workers](https://safeonuba.com/en/developers/reference/workers.md)

Workers and watches.

- `GET /v1/workers`: List workers
- `GET /v1/workers/{id}`: Worker detail
- `GET /v1/devices`: List watches

## [Positions](https://safeonuba.com/en/developers/reference/positions.md)

Only those the privacy veil allows.

- `GET /v1/positions/latest`: Latest visible positions

## [Events](https://safeonuba.com/en/developers/reference/events.md)

Replay the events of the last 30 days.

- `GET /v1/events`: Replay events

## [Webhooks](https://safeonuba.com/en/developers/reference/webhooks.md)

Destinations and the format of what is sent to them.

- `GET /v1/webhooks`: List destinations
- `POST /v1/webhooks`: Create a destination
- `DELETE /v1/webhooks/{id}`: Delete a destination
- `POST /v1/webhooks/{id}/rotate-secret`: Rotate the signing secret
- `POST /v1/webhooks/{id}/test`: Send a test event

## [Sandbox](https://safeonuba.com/en/developers/reference/sandbox.md)

Test scenarios with simulated watches, so you can integrate without watches. Only on `sandbox.api.safeonuba.com`.

- `POST /v1/sandbox/scenarios`: Launch a test scenario

## [Schemas](https://safeonuba.com/en/developers/reference/schemas.md)