Obter lista

GET

/driver

Lista, de forma paginada, os motoristas cadastrados.

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

O resultado respeita o escopo do token: Revendedor vê os motoristas do revendedor; Cliente vê apenas os seus.

Regras

A busca (search) é parcial por nome do motorista e do cliente; exata por CNH, CPF e identificador.

A paginação é controlada pela API (não há perPage).

customerName é retornado vazio no momento.

Datas em ISO 8601. driverCpf vem só com dígitos.

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

🟠422Unprocessable Entity

🟠429Too Many Request

🔴500Internal server error

Request Example

Shell

JavaScript

Java

Swift

curl --location --request GET 'https://api.cloud-services.yuv.com.br/driver' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "search": "João",
    "page": 1
}'

Response Example

200 - Sucesso

{
    "currentPage": 1,
    "data": [
        {
            "driverId": 12,
            "driverName": "João da Silva",
            "driverBirthDate": "1985-03-10T00:00:00.000000Z",
            "driverCnh": "01234567890",
            "driverCnhExpiresAt": "2025-05-20T23:59:59.000000Z",
            "driverMedicalExamExpiresAt": "2025-05-20T23:59:59.000000Z",
            "driverIdentifier": "MOT-001",
            "driverCpf": "12345678900",
            "driverCnhCategories": [
                {
                    "id": 2,
                    "category": "B"
                },
                {
                    "id": 4,
                    "category": "D"
                }
            ],
            "customerName": ""
        }
    ],
    "lastPage": 1,
    "perPage": 20,
    "total": 1
}

Modificado em 2026-10-15 18:07:17

Obter lista

Revendedor x Cliente#

Regras#

Requisição

Respostas

Revendedor x Cliente

Regras