Frota · Referência

Real Condutor

Condutor principal indicado na SENATRAN por placa.

Permissão: real_condutorAções: ler · exportar4 campo(s) LGPD

GET/v1/real_condutorListar GET/v1/real_condutor/{placa}Detalhar GET/v1/real_condutor/exportarExportar em lote

O objeto real condutor

Campo	Tipo	Descrição
`placa`	texto	Placa	filtroordenar
`renavam`	texto	renavam
`modelo`	texto	modelo
`empresa_cnpj`	texto	empresa cnpj
`empresa_nome`	texto	empresa nome
`tem_condutor`	booleano	tem condutor	filtro
`condutor_nome`	texto	condutor nome	LGPD
`condutor_cpf`	texto	condutor cpf	LGPD
`condutor_cnh`	texto	condutor cnh	LGPD
`condutor_desde`	data-hora	condutor desde
`autorizacao`	texto	autorizacao
`ultimo_condutor`	texto	ultimo condutor	LGPD
`excluido_em`	data-hora	excluido em
`motivo_exclusao`	texto	motivo exclusao
`mudou_em`	data-hora	mudou em	ordenar
`verificado_em`	data-hora	verificado em	ordenar

Exemplo do objeto200 OK

{
    "placa": "ABC1D23",
    "renavam": "01234567890",
    "modelo": "LOGAN LIFE 1.0",
    "empresa_cnpj": "texto",
    "empresa_nome": "texto",
    "tem_condutor": false,
    "condutor_nome": "Maria Fernanda Souza",
    "condutor_cpf": "52998224725",
    "condutor_cnh": "texto",
    "condutor_desde": "2026-10-08T14:30:00-03:00",
    "autorizacao": "texto",
    "ultimo_condutor": "texto",
    "excluido_em": "2026-10-08T14:30:00-03:00",
    "motivo_exclusao": "texto",
    "mudou_em": "2026-10-08T14:30:00-03:00",
    "verificado_em": "2026-10-08T14:30:00-03:00"
}

GET Listar

Retorna os registros paginados, do mais recente para o mais antigo (padrão). Requer Ler.

Parâmetros de consulta

Parâmetro	Tipo	Descrição
`pagina`	inteiro	Página (padrão 1)
`por_pagina`	inteiro	1 a 200 (padrão 50)
`ordenar`	texto	Aceita: `placa`, `verificado_em`, `mudou_em` — prefixo `-` para decrescente
`campos`	texto	Lista de campos do objeto, separados por vírgula
`tem_condutor`	booleano	tem condutor — valor exato ou lista separada por vírgula
`placa`	texto	Placa — valor exato ou lista separada por vírgula
`criado_desde` / `criado_ate`	data	Período de criação
`atualizado_desde`	data-hora	Criados ou alterados desde (considera a data de criação)

Requisição

Testar ▸

curl -X GET "https://apimapogos.sixinformatica.com/v1/real_condutor?por_pagina=20" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/real_condutor?por_pagina=20');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST  => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
  ],
]);
$resposta = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($resposta['sucesso']) {
  print_r($resposta['dados']);
} else {
  echo $resposta['erro']['mensagem'];
}

const resposta = await fetch('https://apimapogos.sixinformatica.com/v1/real_condutor?por_pagina=20', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
  },
});
const json = await resposta.json();

if (json.sucesso) console.log(json.dados);
else console.error(json.erro.mensagem);

import os, uuid, requests

resposta = requests.request(
    "GET",
    "https://apimapogos.sixinformatica.com/v1/real_condutor?por_pagina=20",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

Resposta200 OK

{
    "sucesso": true,
    "dados": [
        {
            "placa": "ABC1D23",
            "renavam": "01234567890",
            "modelo": "LOGAN LIFE 1.0",
            "empresa_cnpj": "texto",
            "empresa_nome": "texto",
            "tem_condutor": false,
            "condutor_nome": "Maria Fernanda Souza",
            "condutor_cpf": "52998224725"
        }
    ],
    "meta": {
        "total": 1,
        "pagina": 1,
        "por_pagina": 20,
        "paginas": 1
    },
    "request_id": "req_0f1e2d3c4b5a69788796"
}

GET Detalhar

Retorna um registro pelo placa. Requer Ler.

Erro	Quando
`404 nao_encontrado`	Não existe ou está fora das carteiras da chave
`403 permissao_negada`	Sem Ler no módulo (ou numa relação pedida)

Requisição

Testar ▸

curl -X GET "https://apimapogos.sixinformatica.com/v1/real_condutor/ABC1D23" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/real_condutor/ABC1D23');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST  => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
  ],
]);
$resposta = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($resposta['sucesso']) {
  print_r($resposta['dados']);
} else {
  echo $resposta['erro']['mensagem'];
}

const resposta = await fetch('https://apimapogos.sixinformatica.com/v1/real_condutor/ABC1D23', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
  },
});
const json = await resposta.json();

if (json.sucesso) console.log(json.dados);
else console.error(json.erro.mensagem);

import os, uuid, requests

resposta = requests.request(
    "GET",
    "https://apimapogos.sixinformatica.com/v1/real_condutor/ABC1D23",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

Resposta200 OK

{
    "sucesso": true,
    "dados": {
        "placa": "ABC1D23",
        "renavam": "01234567890",
        "modelo": "LOGAN LIFE 1.0",
        "empresa_cnpj": "texto",
        "empresa_nome": "texto",
        "tem_condutor": false,
        "condutor_nome": "Maria Fernanda Souza",
        "condutor_cpf": "52998224725"
    },
    "request_id": "req_1d2c3b4a5f6e7d8c9b0a"
}

GET Exportar em lote

Até 1000 registros por chamada, paginando por cursor. Requer Ler e Exportar. Aceita os mesmos filtros da listagem e formato=csv. Detalhes no guia Exportação em lote.

Requisição

Testar ▸

curl -X GET "https://apimapogos.sixinformatica.com/v1/real_condutor/exportar?limite=1000" \
  -H "Authorization: Bearer $MAPOGOS_API_KEY"

<?php
$ch = curl_init('https://apimapogos.sixinformatica.com/v1/real_condutor/exportar?limite=1000');
curl_setopt_array($ch, [
  CURLOPT_CUSTOMREQUEST  => 'GET',
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER     => [
    'Authorization: Bearer ' . getenv('MAPOGOS_API_KEY'),
  ],
]);
$resposta = json_decode(curl_exec($ch), true);
$http = curl_getinfo($ch, CURLINFO_RESPONSE_CODE);

if ($resposta['sucesso']) {
  print_r($resposta['dados']);
} else {
  echo $resposta['erro']['mensagem'];
}

const resposta = await fetch('https://apimapogos.sixinformatica.com/v1/real_condutor/exportar?limite=1000', {
  method: 'GET',
  headers: {
    Authorization: `Bearer ${process.env.MAPOGOS_API_KEY}`,
  },
});
const json = await resposta.json();

if (json.sucesso) console.log(json.dados);
else console.error(json.erro.mensagem);

import os, uuid, requests

resposta = requests.request(
    "GET",
    "https://apimapogos.sixinformatica.com/v1/real_condutor/exportar?limite=1000",
    headers={"Authorization": f"Bearer {os.environ['MAPOGOS_API_KEY']}"},
    timeout=30,
)
json = resposta.json()
print(json["dados"] if json["sucesso"] else json["erro"]["mensagem"])

Recursos incluídos neste módulo

Estes recursos usam a mesma permissão de Real Condutor:

Rota	Recurso	Descrição	Campos
`/v1/indicacoes_condutor`	Indicações de condutor	Processo de indicação do condutor (pedido de CNH, prazo, situação).	`id`, `vehicle_id`, `rental_id`, `client_id`, `plate`, `status`, `motivo`, `cnh_on_file` …