Obter lista

GET

/device

Lista, de forma paginada, os equipamentos do revendedor, com ativo, cliente e chip vinculados.

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

⚠️ 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).

Regras

Todos os campos do corpo são opcionais.

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

Modelos e firmwares: https://app.apidog.com/project/922569/apis/doc-1335233

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/device' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "search": "8649",
    "page": 1,
    "perPage": 20
}'

Response Example

200 - Sucesso

{
    "currentPage": 1,
    "data": [
        {
            "deviceId": 12345,
            "deviceModelId": 16,
            "deviceImei": "12345678912",
            "deviceLastHeartbeat": "2025-10-08T14:35:12Z",
            "deviceLastGps": "2025-10-08T14:34:00Z",
            "deviceFirmwareId": 42,
            "deviceIsEnabled": true,
            "deviceNetworkType": "4G",
            "deviceManufacturerName": "Jimi Brasil",
            "deviceModelName": "JC450",
            "deviceOnline": true,
            "assetId": 9876,
            "assetPrefix": "INF",
            "assetIdentifier": "INF-400-2",
            "customerId": 321,
            "customerName": "Example Customer",
            "simCardId": 5555,
            "simCardNumber": "+5511999999999"
        }
    ],
    "lastPage": 1,
    "perPage": 20,
    "total": 1
}

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

Obter lista

Regras#

Requisição

Respostas

Regras