API Reference | Checktudo Developers

Agregados

POSThttps://pwe6qnayhg.execute-api.sa-east-1.amazonaws.com/queries/integration/agregados

Consulta veicular completa com dados agregados. Retorna informações consolidadas do veículo.

ℹ️Consulta Básica

Retorna dados consolidados do veículo: identificação (placa, chassi, renavam), características (marca, modelo, ano), classificação (tipo, espécie) e situação atual.

⚠️Verificação de Duplicidade

Consultas com as mesmas chaves dentro de 1 hora são bloqueadas por padrão. Para forçar uma nova consulta, envie o parâmetro duplicity: true no body.

Body

keys*

licensePlatePlaca do veículo (formato: ABC1234 ou ABC1D23)

chassisNúmero do chassi (17 caracteres)

renavamCódigo Renavam (11 dígitos)

duplicity

Campos da Resposta

Identificação do Veículo

Dados de identificação únicos do veículo

Campo	Tipo	Descrição
`placa`	string	Placa do veículo
`chassi`	string	Número do chassi (17 caracteres)
`renavam`	string	Código Renavam (11 dígitos)
`numeroMotor`	string	Número do motor

Características do Veículo

Informações sobre marca, modelo e especificações

Campo	Tipo	Descrição
`marca`	string	Marca do fabricante
`modelo`	string	Modelo do veículo
`marcaModelo`	string	Marca/Modelo concatenados
`anoFabricacao`	string	Ano de fabricação
`anoModelo`	string	Ano do modelo
`combustivel`	string	Tipo de combustível
`corVeiculo`	string	Cor do veículo

Classificação

Tipo e categoria do veículo

Campo	Tipo	Descrição
`tipoVeiculo`	string	Tipo (AUTOMOVEL, MOTOCICLETA, etc.)
`tipoCarroceria`	string	Tipo de carroceria
`especieVeiculo`	string	Espécie (PASSAGEIRO, CARGA, etc.)
`nacionalidade`	string	Nacional ou importado

Situação e Localização

Status atual e localização do registro

Campo	Tipo	Descrição
`situacaoVeiculo`	string	Situação atual (CIRCULACAO, etc.)
`situacaoChassi`	string	Situação do chassi (NORMAL, REMARCADO)
`uf`	string	Estado de registro
`municipio`	string	Município de registro

Especificações Técnicas

Dados técnicos do veículo

Campo	Tipo	Descrição
`potencia`	string	Potência em CV
`cilindradas`	string	Cilindradas do motor
`capacidadePassageiro`	string	Número de passageiros

LINGUAGEM

CREDENCIAIS

+ HEADER

Header🔒

Requisição cURL ▾Exemplos ▾

1curl --request POST \
2     --url https://pwe6qnayhg.execute-api.sa-east-1.amazonaws.com/queries/integration/agregados \
3     --header 'Content-Type: application/json' \
4     --header 'x-api-key: $api_key' \
5     --data '{"keys":{}}'

RESPOSTA

Clique em Testar! para fazer uma requisição e ver a resposta aqui! Ou escolha um exemplo:

application/json