Obter lista

GET

/occurrence

Lista, de forma paginada, as ocorrências (alarmes agrupados que precisam de tratativa) dos equipamentos informados no período.

Disponível para: Revendedor e Cliente
Rate limit: 100 requisições/minuto

📌 Esta é a versão da documentação para token de Revendedor.

⚠️ Apesar de ser GET, os filtros são enviados no corpo JSON da requisição (não na query string). O corpo é obrigatório: sem filtros, envie {} (sem corpo a API responde 400).

Revendedor x Cliente

Revendedor: customerIds é obrigatório. Sem ele a API responde 400 ("customerIds é obrigatório").

Cliente: customerIds não é necessário; a API usa automaticamente o cliente do token.

Regras

IMEIs fora do seu escopo são ignorados.

startDate e endDate no formato AAAA-MM-DD hh:mm:ss.

status: handled (já tratadas) ou notHandled (pendentes). Omita para trazer todas.

perPage vai de 1 a 100 (padrão 20).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros Bodyapplication/jsonObrigatório

Examples

Respostas

🟢200Sucesso

application/json

Bodyapplication/json

🟠400Bad request

🟠403Forbidden

🔴500Internal server error

🟠429Too Many Request

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.cloud-services.yuv.com.br/occurrence' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "alarms": [
        1,
        2
    ],
    "deviceImeis": [
        "864993060000000"
    ],
    "customerIds": [
        45
    ],
    "startDate": "2025-05-20 00:00:00",
    "endDate": "2025-05-20 23:59:59",
    "status": "notHandled",
    "page": 1,
    "perPage": 20
}'

Response Example

200 - Sucesso

{
    "currentPage": 1,
    "data": [
        {
            "alarmType": "Fadiga",
            "assetPrefix": "CAM-01",
            "assetIdentifier": "ABC1D23",
            "customerName": "Transportadora Exemplo",
            "deviceImei": "864993060000000",
            "occurrenceId": 987,
            "occurrenceLastAlarmAt": "2025-05-20 07:42:30",
            "occurrenceStatus": null,
            "alarms": [
                {
                    "alarmId": 555,
                    "latitude": -23.55052,
                    "longitude": -46.633308,
                    "datetime": "2025-05-20 07:42:30",
                    "speed": 54,
                    "gpsNumber": 12
                }
            ]
        }
    ],
    "lastPage": 1,
    "perPage": 20,
    "total": 1
}

Modificado em 2026-10-02 19:54:03

Obter lista

Revendedor x Cliente#

Regras#

Requisição

Respostas

Revendedor x Cliente

Regras