Referencia

Evacuaciones

Estado, recuento por estado y por punto, descartes y quién falta.

Listar evacuaciones

GET/v1/musters

Scope musters:read

Parámetros de consulta

site_idstring (uuid)
statusstring
Valores posibles: activecompletedcancelled
sincestring (date-time)
limitinteger
Elementos por página (máximo 500).
de 1 a 500 · por defecto 100
cursorstring
El next_cursor de la página anterior.

Respuestas

200
Evacuaciones activas e históricas.
application/json MusterPage
401
Falta el token, ha caducado o se ha revocado.
application/problem+json Problem
403
Al token le falta el scope que pide la ruta, o el centro no es del cliente.
application/problem+json Problem
429
Demasiadas peticiones, o demasiado tiempo de consulta: cada cliente tiene un número de peticiones por minuto (600 de serie) y un tiempo de consulta por minuto (30 s de serie), y cada petición gasta lo que tarda, así que una lista larga cuenta más que una alerta suelta. Retry-After dice cuándo volver.
application/problem+json Problem

Petición · sandbox

curl "https://sandbox.api.safeonuba.com/v1/musters" \
  -H "Authorization: Bearer $SAFEONUBA_TOKEN"

const res = await fetch('https://sandbox.api.safeonuba.com/v1/musters', {
  headers: {
    Authorization: `Bearer ${process.env.SAFEONUBA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

res = requests.get(
    "https://sandbox.api.safeonuba.com/v1/musters",
    headers={"Authorization": f"Bearer {os.environ['SAFEONUBA_TOKEN']}"},
    timeout=10,
)
res.raise_for_status()
data = res.json()

using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("SAFEONUBA_TOKEN"));

var res = await http.GetAsync("https://sandbox.api.safeonuba.com/v1/musters");
res.EnsureSuccessStatusCode();
var json = await res.Content.ReadAsStringAsync();

Respuesta 200

JSON

{
  "data": [
    {
      "id": "4fb94227-7afb-442d-a672-6fd82069518f",
      "site": {
        "id": "11111111-1111-1111-1111-111111111111",
        "name": "Planta Ejemplo — simulación"
      },
      "status": "active",
      "phase": "evacuating",
      "kind": "general",
      "reason": "Fuga en Mantenimiento",
      "started_at": "2026-09-24T18:31:06Z",
      "ended_at": null,
      "deadline": null,
      "origin": {
        "latitude": 39.97894,
        "longitude": -2.96877,
        "radius_m": 400,
        "label": "Mantenimiento — permiso PT-0453",
        "zone": {
          "id": "22222222-2222-2222-2222-222222222203",
          "name": "Mantenimiento — permiso PT-0453"
        }
      },
      "targets_revision": 3,
      "totals": {
        "expected": 9,
        "safe": 6,
        "help": 0,
        "wrong_point": 0,
        "pending": 2,
        "no_signal": 0,
        "not_worn": 1
      },
      "assembly_points": [
        {
          "id": "22222222-2222-2222-2222-222222222204",
          "name": "Punto de reunión PR-1",
          "status": "excluded",
          "count": 0,
          "excluded": {
            "reason": "A 371 m del origen (radio 400 m)",
            "recommended": true,
            "at": "2026-09-24T18:31:06Z",
            "by": "Elena Ejemplo"
          }
        },
        {
          "id": "22222222-2222-2222-2222-222222222205",
          "name": "Punto de reunión PR-2",
          "status": "excluded",
          "count": 0,
          "excluded": {
            "reason": "A sotavento: viento del SO a 9 km/h",
            "recommended": true,
            "at": "2026-09-24T18:31:42Z",
            "by": "Elena Ejemplo"
          }
        },
        {
          "id": "f6040b41-be81-4bf3-af68-bfaf3e284c54",
          "name": "Punto de reunión PR-3 · Zona alta",
          "status": "available",
          "count": 6,
          "excluded": null
        }
      ]
    }
  ],
  "next_cursor": "eyJ0IjoiMjAyNi0wOS0yNFQxMTowNDoxMloifQ"
}

Estado y recuento de una evacuación

GET/v1/musters/{id}

Scope musters:read

El recuento lo cuenta el servidor con la misma regla que el panel y el cierre: posición precisa dentro de un punto válido, o llegada declarada a uno.

Parámetros de ruta

idstring (uuid)obligatorio
Id de la evacuación.

Respuestas

200
La evacuación.
application/json Muster
401
Falta el token, ha caducado o se ha revocado.
application/problem+json Problem
403
Al token le falta el scope que pide la ruta, o el centro no es del cliente.
application/problem+json Problem
404
No existe o no es de un centro del cliente.
application/problem+json Problem
429
Demasiadas peticiones, o demasiado tiempo de consulta: cada cliente tiene un número de peticiones por minuto (600 de serie) y un tiempo de consulta por minuto (30 s de serie), y cada petición gasta lo que tarda, así que una lista larga cuenta más que una alerta suelta. Retry-After dice cuándo volver.
application/problem+json Problem

Petición · sandbox

curl "https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90" \
  -H "Authorization: Bearer $SAFEONUBA_TOKEN"

const res = await fetch('https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90', {
  headers: {
    Authorization: `Bearer ${process.env.SAFEONUBA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

res = requests.get(
    "https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90",
    headers={"Authorization": f"Bearer {os.environ['SAFEONUBA_TOKEN']}"},
    timeout=10,
)
res.raise_for_status()
data = res.json()

using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("SAFEONUBA_TOKEN"));

var res = await http.GetAsync("https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90");
res.EnsureSuccessStatusCode();
var json = await res.Content.ReadAsStringAsync();

Respuesta 200

JSON

{
  "id": "4fb94227-7afb-442d-a672-6fd82069518f",
  "site": {
    "id": "11111111-1111-1111-1111-111111111111",
    "name": "Planta Ejemplo — simulación"
  },
  "status": "active",
  "phase": "evacuating",
  "kind": "general",
  "reason": "Fuga en Mantenimiento",
  "started_at": "2026-09-24T18:31:06Z",
  "ended_at": null,
  "deadline": null,
  "origin": {
    "latitude": 39.97894,
    "longitude": -2.96877,
    "radius_m": 400,
    "label": "Mantenimiento — permiso PT-0453",
    "zone": {
      "id": "22222222-2222-2222-2222-222222222203",
      "name": "Mantenimiento — permiso PT-0453"
    }
  },
  "targets_revision": 3,
  "totals": {
    "expected": 9,
    "safe": 6,
    "help": 0,
    "wrong_point": 0,
    "pending": 2,
    "no_signal": 0,
    "not_worn": 1
  },
  "assembly_points": [
    {
      "id": "22222222-2222-2222-2222-222222222204",
      "name": "Punto de reunión PR-1",
      "status": "excluded",
      "count": 0,
      "excluded": {
        "reason": "A 371 m del origen (radio 400 m)",
        "recommended": true,
        "at": "2026-09-24T18:31:06Z",
        "by": "Elena Ejemplo"
      }
    },
    {
      "id": "22222222-2222-2222-2222-222222222205",
      "name": "Punto de reunión PR-2",
      "status": "excluded",
      "count": 0,
      "excluded": {
        "reason": "A sotavento: viento del SO a 9 km/h",
        "recommended": true,
        "at": "2026-09-24T18:31:42Z",
        "by": "Elena Ejemplo"
      }
    },
    {
      "id": "f6040b41-be81-4bf3-af68-bfaf3e284c54",
      "name": "Punto de reunión PR-3 · Zona alta",
      "status": "available",
      "count": 6,
      "excluded": null
    }
  ]
}

Quién falta

GET/v1/musters/{id}/missing

Scope musters:read

Primero quien pide ayuda o necesita rescate, después quien está en un punto que no sirve, sin señal, sin el reloj puesto y saliendo. La última posición solo con el scope positions:read, y si el velo la deja ver.

Parámetros de ruta

idstring (uuid)obligatorio
Id de la evacuación.

Respuestas

200
Quién falta, por urgencia.
application/json MissingWorkerList
401
Falta el token, ha caducado o se ha revocado.
application/problem+json Problem
403
Al token le falta el scope que pide la ruta, o el centro no es del cliente.
application/problem+json Problem
404
No existe o no es de un centro del cliente.
application/problem+json Problem
429
Demasiadas peticiones, o demasiado tiempo de consulta: cada cliente tiene un número de peticiones por minuto (600 de serie) y un tiempo de consulta por minuto (30 s de serie), y cada petición gasta lo que tarda, así que una lista larga cuenta más que una alerta suelta. Retry-After dice cuándo volver.
application/problem+json Problem

Petición · sandbox

curl "https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90/missing" \
  -H "Authorization: Bearer $SAFEONUBA_TOKEN"

const res = await fetch('https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90/missing', {
  headers: {
    Authorization: `Bearer ${process.env.SAFEONUBA_TOKEN}`,
  },
});
if (!res.ok) throw new Error(`${res.status}: ${await res.text()}`);
const data = await res.json();

import os
import requests

res = requests.get(
    "https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90/missing",
    headers={"Authorization": f"Bearer {os.environ['SAFEONUBA_TOKEN']}"},
    timeout=10,
)
res.raise_for_status()
data = res.json()

using System.Net.Http.Headers;

using var http = new HttpClient();
http.DefaultRequestHeaders.Authorization = new AuthenticationHeaderValue(
    "Bearer", Environment.GetEnvironmentVariable("SAFEONUBA_TOKEN"));

var res = await http.GetAsync("https://sandbox.api.safeonuba.com/v1/musters/0f6c2b7e-3a1d-4c55-9b0e-7d2f4a8c1e90/missing");
res.EnsureSuccessStatusCode();
var json = await res.Content.ReadAsStringAsync();

Respuesta 200

JSON

{
  "data": [
    {
      "worker": {
        "id": "33333333-3333-3333-3333-333333333305",
        "external_id": "EMP-004512",
        "contractor": "Contrata Ejemplo A"
      },
      "device": {
        "id": "44444444-4444-4444-4444-444444444405",
        "serial": "OS-W-0005",
        "battery": 61,
        "date_last_seen": "2026-09-24T18:33:40Z"
      },
      "status": "wrong_point",
      "needs_rescue": false,
      "help_reason": null,
      "assembly_point": {
        "id": "22222222-2222-2222-2222-222222222205",
        "name": "Punto de reunión PR-2",
        "valid": false
      },
      "declared_at": "2026-09-24T18:32:10Z",
      "last_seen_at": "2026-09-24T18:33:40Z",
      "location": null,
      "location_withheld": false
    }
  ]
}

Evacuaciones

Listar evacuaciones#

Parámetros de consulta

Respuestas

Estado y recuento de una evacuación#

Parámetros de ruta

Respuestas

Quién falta#

Parámetros de ruta

Respuestas

Listar evacuaciones

Estado y recuento de una evacuación

Quién falta