documentostringRequiredQueried carrier's CPF or CNPJ, digits only.
Technical descriptions are translated from the versioned contract. Original identifiers and JSON are preserved; data examples are omitted.
rntrcstringRequiredThe queried RNTRC.
razao_socialstring | nullOptionalThe carrier's legal name (or individual name) in ANTT's registry.
In the sandbox environment, where queries use simulated mode, the real name is not returned: the entire field is replaced with one of two fixed values, depending on the queried document —
documento | razao_social |
|---|---|
| CNPJ (14 digits) | TRANSPORTES SIMULADOS HML LTDA |
| CPF (11 digits, self-employed carrier) | TRANSPORTADOR AUTONOMO SIMULADO |
This indicates that the data was not checked with ANTT.
data_validadestring | null · dateOptionalThe RNTRC registration's expiration date, in AAAA-MM-DD format.
null when the provider does not report an expiration date — this is not the same as expired. Treat missing and expired dates as different cases.
In the sandbox environment, where queries use simulated mode, the date is derived from the query date: an active registration returns today + 1 year; the inactive-registration sentinel (rntrc=000000000) returns today − 1 year, because an expired RNTRC is the most common cause of inactivity, and a future expiration date alongside ativo: false would be contradictory.
This is the only field in this query that is not fixed across days: the others are deterministic, while this one follows the date to avoid becoming stale.
ativobooleanRequiredWhether the RNTRC is active with ANTT.
tipostringRequiredCarrier type: ETC (company), TAC (self-employed) or CTC (cooperative).
"ETC" · "TAC" · "CTC"equiparado_tacbooleanOptionalWhether the carrier is treated as equivalent to a TAC.
Original JSON Definition (Portuguese Descriptions)
{
"type": "object",
"required": [
"documento",
"rntrc",
"ativo",
"tipo"
],
"properties": {
"documento": {
"type": "string",
"description": "CPF ou CNPJ do transportador consultado, somente dígitos."
},
"rntrc": {
"type": "string",
"description": "O RNTRC consultado."
},
"razao_social": {
"type": [
"string",
"null"
],
"description": "Razão social (ou nome) do transportador no registro da ANTT.\n\nEm homologação, onde a consulta responde em modo simulado, o nome real **não é\ndevolvido**: o campo inteiro é substituído por um de dois valores fixos, conforme o\ndocumento consultado —\n\n| `documento` | `razao_social` |\n|---|---|\n| CNPJ (14 dígitos) | `TRANSPORTES SIMULADOS HML LTDA` |\n| CPF (11 dígitos, transportador autônomo) | `TRANSPORTADOR AUTONOMO SIMULADO` |\n\nÉ o marcador de que o dado não foi apurado na ANTT.\n"
},
"data_validade": {
"type": [
"string",
"null"
],
"format": "date",
"description": "Até quando o registro no RNTRC é válido, em `AAAA-MM-DD`.\n\n`null` quando o provedor não informa a validade — o que **não** é o mesmo que\nvencido. Trate ausência e vencimento como casos distintos.\n\nEm homologação, onde a consulta responde em modo simulado, a data é derivada do\n**dia da consulta**: registro ativo devolve hoje + 1 ano; a sentinela de registro\ninativo (`rntrc=000000000`) devolve hoje − 1 ano, porque um RNTRC vencido é a\ncausa mais comum de inatividade e devolver validade futura junto de\n`ativo: false` seria uma resposta que se contradiz.\n\nÉ o único campo desta consulta que **não** é fixo entre dias: os demais são\ndeterminísticos, e este acompanha a data para não envelhecer.\n"
},
"ativo": {
"type": "boolean",
"description": "Se o RNTRC está ativo na ANTT."
},
"tipo": {
"type": "string",
"enum": [
"ETC",
"TAC",
"CTC"
],
"description": "Tipo do transportador: `ETC` (empresa), `TAC` (autônomo) ou `CTC` (cooperativa)."
},
"equiparado_tac": {
"type": "boolean",
"description": "Se o transportador é equiparado a TAC."
}
}
}