Transportador ANTT (RNTRC)

Situação do transportador no RNTRC e se o veículo está na frota dele, por CPF, CNPJ ou RNTRC.

Entrada: CPF, CNPJ ou RNTRC + placa opcionalAssíncrona (requestId)Exige termo de finalidade

Gerar chave de API Ver preços

Quando usar

Contratação de frete

Confirme que o transportador está apto antes de carregar.

Gestão de agregados

Revalide a situação da sua base de transportadores periodicamente.

Seguro de carga

Garanta que o veículo informado está cadastrado na frota.

Como funciona

Fluxo assíncrono

Seu sistemaAPI

1POSTCriar consulta
Envia o documento e recebe o requestId na hora.
2GETAcompanhar
Repete a chamada com o requestId enquanto o status for pending.
3GETBuscar resultado
Com status done, o resultado completo vem em data.

Exige termo de finalidade

Antes da primeira chamada, aceite o termo desta consulta no painel, em Minha conta > Aceites e finalidade. Sem o aceite, a criação responde 403 com o código PURPOSE_NOT_ACCEPTED.

Consulta repetida sem cobrança

A mesma combinação de documento e placa consultada de novo dentro de 24 horas reaproveita o resultado anterior e responde ignored: true.

Sem cobrança em caso de falha

Se a consulta terminar com erro, o valor volta para o saldo automaticamente.

Passo 1

Criar consulta

POST/api/partner/v2/antt/transporter

Cria uma consulta assíncrona da situação do transportador no RNTRC (Registro Nacional de Transportadores Rodoviários de Cargas). Informe CPF, CNPJ ou RNTRC e, opcionalmente, a placa para conferir se o veículo está na frota do transportador.

Importante:

Exige o termo de finalidade de Transportador ANTT aceito no painel; sem ele a resposta é 403 com code: PURPOSE_NOT_ACCEPTED
A mesma combinação de documento e placa consultada de novo dentro de 24 horas reaproveita o resultado anterior sem nova cobrança (ignored: true)
Falhas na consulta são reembolsadas automaticamente

Corpo da requisição

documentstringobrigatório
CPF, CNPJ ou RNTRC do transportador. Pontuação é aceita e removida antes da consulta.
licensePlatestringopcional
Placa do veículo (padrão antigo ou Mercosul). Opcional.

Respostas

200Solicitação criada com sucesso
400Documento, RNTRC ou placa inválidos
401Token ausente ou inválido
402Consulta não habilitada ou saldo insuficiente
403Termo de finalidade não aceito ou documento com restrição de privacidade

Requisição

curl -X POST "https://consultadeprocessos.com.br/api/partner/v2/antt/transporter" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API" \
  -H "Content-Type: application/json" \
  -d '{"document":"12345678000195"}'

Resposta · 200

{
  "requestId": "cm8p1q2r30004ab12cdef5678",
  "message": "Solicitação realizada com sucesso"
}

Passo 2

Buscar resultado

GET/api/partner/v2/antt/transporter/{requestId}

Consulte este endpoint com o requestId recebido no POST até receber o status done ou error. Sem cadastro na ANTT, found vem false e transporter vem null.

Parâmetros do caminho

requestIdstringno caminhoobrigatório
ID retornado ao criar a consulta

Respostas

200Estado atual ou resultado da solicitação
401Token ausente ou inválido
403A solicitação pertence a outro usuário
404Solicitação não encontrada

Requisição

curl -X GET "https://consultadeprocessos.com.br/api/partner/v2/antt/transporter/cm8p1q2r30004ab12cdef5678" \
  -H "Authorization: Bearer SUA_CHAVE_DE_API"

Resposta · 200

{
  "data": {
    "query": {
      "identifier": "12345678000195",
      "identifierType": "cnpj",
      "licensePlate": "ABC1D23"
    },
    "found": true,
    "transporter": {
      "name": "TRANSPORTES EXEMPLO LTDA",
      "rntrc": "012345678",
      "document": "12345678000195",
      "documentType": "CNPJ",
      "status": "ATIVO",
      "active": true,
      "fit": true,
      "registrationMessage": "O transportador está apto a realizar o transporte remunerado de cargas e o veículo está cadastrado em sua frota.",
      "registrationDate": "2015-06-01T00:00:00.000Z",
      "expirationDate": "2027-06-01T00:00:00.000Z",
      "city": "CAMPINAS",
      "state": "SP"
    },
    "vehicle": {
      "licensePlate": "ABC1D23",
      "inFleet": true,
      "type": "CAMINHÃO TRATOR"
    },
    "freightPaymentNotice": null,
    "verifiedAt": "2026-10-08T12:00:00.000Z"
  },
  "status": "done"
}

O que a resposta traz

Transportador

Nome e RNTRC
transporter.name · rntrc
Situação no registro (ativo, suspenso, cancelado)
status · active
Se está apto ao transporte remunerado de cargas
fit · registrationMessage
Cidade, UF, data de cadastro e validade
city · state · registrationDate · expirationDate

Veículo (quando a placa é informada)

Se a placa está cadastrada na frota do transportador
vehicle.inFleet
null quando a ANTT não informa.
Tipo do veículo
vehicle.type

Pagamento de frete

Obrigatoriedade do Pagamento Eletrônico de Frete (art. 5-A da Lei 11.442/2007)
freightPaymentNotice

Todos os campos da resposta (26)

statusstring
done
dataobject
data.queryobject
data.query.identifierstring
CPF, CNPJ ou RNTRC consultado, só com dígitos
data.query.identifierTypestring
cpfcnpjrntrc
data.query.licensePlatestring | null
data.foundboolean
Se o transportador tem cadastro no RNTRC
data.transporterobject | null
data.transporter.namestring | null
data.transporter.rntrcstring | null
data.transporter.documentstring | null
data.transporter.documentTypestring | null
data.transporter.statusstring | null
Situação no registro (ex.: ATIVO, SUSPENSO, CANCELADO)
data.transporter.activeboolean
Situação ATIVO no registro
data.transporter.fitboolean
Se está apto ao transporte remunerado de cargas
data.transporter.registrationMessagestring | null
Mensagem da ANTT sobre a situação do transportador e do veículo
data.transporter.registrationDatestring | null
data.transporter.expirationDatestring | null
data.transporter.citystring | null
data.transporter.statestring | null
data.vehicleobject | null
Presente só quando a placa foi informada
data.vehicle.licensePlatestring
data.vehicle.inFleetboolean | null
Se a placa está na frota do transportador; null quando a ANTT não informa
data.vehicle.typestring | null
Tipo do veículo
data.freightPaymentNoticestring | null
Aviso sobre a obrigatoriedade do Pagamento Eletrônico de Frete (art. 5-A da Lei 11.442/2007)
data.verifiedAtstring | null
Momento em que a situação foi verificada na ANTT

Valores por plano

Plano mensal	Valor da consulta
Sob demanda	R$ 2,40
R$ 100/mês até 126 consultas	R$ 0,79
R$ 300/mês até 434 consultas	R$ 0,69
R$ 500/mês até 769 consultas	R$ 0,65
R$ 1.000/mês até 1.694 consultas	R$ 0,59
R$ 3.000/mês até 5.769 consultas	R$ 0,52
R$ 10.000/mês até 21.739 consultas	R$ 0,46
R$ 20.000/mês até 50.000 consultas	R$ 0,40

O valor é cobrado por consulta, na criação da consulta. Ler o resultado de novo pelo mesmo requestId não gera nova cobrança.

Sem plano, a conta usa o valor Sob demanda e paga só o que consumir.

Comparar planos

Próximos passos

Autenticação

Gere a chave e envie no cabeçalho.

Erros e códigos

Como tratar cada resposta de erro.

Cobrança e reembolso

Quando cobramos e quando o valor volta.