1. Ocorrências
Yuv Cloud Services
prod
  • prod
  • quality
  • Introdução
  • Referências
  • Data Push
    • /pushFileDownloadRequest
    • /occurrence
    • JC181
      • /jc181/pushHeartbeat
      • /jc181/pushGps
      • /jc181/pushAlarm
      • /jc181/pushAlarmFile
      • /jc181/pushFileList
    • JC182
      • /jc182/pushGps
      • /jc182/pushHeartbeat
      • /jc182/pushFileList
      • /jc182/pushAlarm
      • /jc182/pushAlarmFile
    • JC371
      • /jc371/pushGps
      • /jc371/pushHeartbeat
      • /jc371/pushAlarm
      • /jc371/pushAlarmFile
      • /jc371/pushFileList
    • JC400
      • /jc400/pushHeartbeat
      • /jc400/pushGps
      • /jc400/pushAlarm
      • /jc400/pushAlarmFile
      • /jc400/pushFileList
    • JC450
      • /jc450/pushHeartbeat
      • /jc450/pushGps
      • /jc450/pushAlarm
      • /jc450/pushAlarmFile
      • /jc450/pushFileList
  • API (Revendedor)
    • Alarmes
      • Obter Alarmes
    • Ativos
      • Obter lista
      • Visualizar
      • Cadastrar
      • Editar
      • Vincular/Desvincular equipamento
      • Deletar
    • Equipamentos
      • Obter lista para seleção
      • Obter lista
      • Abrir streaming
      • Visualizar
      • Cadastrar
      • Editar
      • Deletar
      • Enviar comando
    • Clientes
      • Obter lista
      • Editar
      • Obter token
      • Cadastrar token
      • Cadastrar
      • Deletar
      • Deletar token
    • Downloads
      • Requisitar lista de arquivos
      • Requisitar arquivo
    • Playback
      • Streaming
    • Motoristas
      • Obter lista
      • Cadastrar
    • Ocorrências
      • Obter lista
      • Tratativa
    • Grupo de Permissão
      • Obter lista
    • GPS
      • Obter GPS
      • Obter Deslocamento
    • Manutenções
      • Obter lista
    • Abastecimentos
      • Obter lista
  • API (Cliente)
    • Controle de Acesso
    • Alarmes
      • Obter Alarmes
    • Equipamentos
      • Obter lista
      • Abrir streaming
    • Motoristas
      • Obter lista
      • Cadastrar
    • Ocorrências
      • Tratativa
        POST
      • Obter lista
        GET
    • GPS
      • Obter GPS
      • Obter Deslocamento
    • Manutenções
      • Obter lista
    • Abastecimentos
      • Obter lista
  1. Ocorrências

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 Cliente.
⚠️ 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.
severity é a gravidade configurada para o tipo de alarme: Alto, Médio ou Baixo (sempre em português).
handled indica se a ocorrência já foi tratada; falsePositive e observation vêm da tratativa (false e null enquanto não houver tratativa).
alarms[].datetime vem em UTC no formato ISO 8601 (2025-05-20T07:42:30Z).
perPage vai de 1 a 100 (padrão 20).
O cliente é sempre o do token; se customerIds for enviado, ele é ignorado.

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 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"
    ],
    "startDate": "2025-05-20 00:00:00",
    "endDate": "2025-05-20 23:59:59",
    "status": "notHandled",
    "page": 1,
    "perPage": 20
}'
Response 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": "SEM RISCO",
            "alarms": [
                {
                    "alarmId": 554,
                    "latitude": -23.55052,
                    "longitude": -46.633308,
                    "datetime": "2025-05-20T07:41:58Z",
                    "speed": 52,
                    "gpsNumber": 11
                },
                {
                    "alarmId": 555,
                    "latitude": -23.55061,
                    "longitude": -46.633401,
                    "datetime": "2025-05-20T07:42:30Z",
                    "speed": 54,
                    "gpsNumber": 12
                }
            ],
            "severity": "Alto",
            "handled": true,
            "falsePositive": false,
            "observation": "Motorista orientado pelo gestor da frota."
        },
        {
            "alarmType": "Uso de celular",
            "assetPrefix": null,
            "assetIdentifier": "DEF4G56",
            "customerName": "Transportadora Exemplo",
            "deviceImei": "864993060000001",
            "occurrenceId": 988,
            "occurrenceLastAlarmAt": "2025-05-20 09:10:05",
            "occurrenceStatus": null,
            "alarms": [
                {
                    "alarmId": 601,
                    "latitude": -23.56012,
                    "longitude": -46.640211,
                    "datetime": "2025-05-20T09:10:05Z",
                    "speed": 0,
                    "gpsNumber": 9
                }
            ],
            "severity": "Médio",
            "handled": false,
            "falsePositive": false,
            "observation": null
        }
    ],
    "lastPage": 1,
    "perPage": 20,
    "total": 2
}
Modificado em 2026-10-15 17:54:23
Página anterior
Tratativa
Próxima página
Obter GPS
Built with