Consulta de navios
O registro de navios da International Maritime Organization: bandeira, tipo, arqueação, proprietário e situação em sanções da ONU, por número IMO ou por nome.
Para que serve
Conferir se o navio de um BL, de uma reserva ou de um cadastro existe no registro da IMO, e ter os dados dele sem digitar: bandeira, tipo, arqueação bruta, ano de construção, proprietário e situação na lista de sanções da ONU.
O número IMO identifica o casco pela vida inteira, mesmo quando o navio muda de nome ou de bandeira, e tem dígito verificador. Quando o documento trouxer o número, confira por ele.
Três rotas
| Rota | O que faz |
|---|---|
POST /v1/navios/verificar | Confere um navio pelo nome, pelo número IMO ou pelos dois |
GET /v1/navios/{imo} | Um navio pelo número IMO |
GET /v1/navios | Busca por número ou por nome, e listagem paginada |
Respondem na hora, sem job e sem webhook. Use a mesma chave de autenticação das outras rotas. O número vale com ou sem o prefixo: IMO 9312573, IMO9312573 e 9312573 são o mesmo.
Conferir um navio
Mande o navio como está no documento. O nome aceita o prefixo M/V e qualquer caixa.
curl -X POST "https://comexdoc.com.br/v1/navios/verificar" \
-H "Authorization: Bearer cxd_live_..." \
-H "Content-Type: application/json" \
-d '{"nome": "M/V XIN WEI HAI"}'
{
"estado": "confere_nome",
"nome_consultado": "M/V XIN WEI HAI",
"imo_consultado": null,
"imo_valido": null,
"navios": [
{ "imo": "9312573", "nome": "XIN WEI HAI", "bandeira": "China",
"tipo": "Container Ship (Fully Cellular)", "arqueacao_bruta": 41482,
"data_construcao": "2006-01", "consultado_na_imo_em": "2026-09-12T14:02:11Z", ... }
],
"nome_difere": false,
"fonte": "International Maritime Organization · GISIS"
}| estado | O que significa |
|---|---|
confere_imo | O número IMO está no registro. |
confere_nome | Um navio com este nome está no registro. |
confere_nome_varios | Mais de um navio tem este nome. Todos vêm em navios; confira pelo número. |
nao_encontrado | O registro não tem navio com este nome nem com este número. |
pendente | O navio ainda não estava na base, e a consulta ao registro foi pedida. Repita em alguns minutos. |
indisponivel | A consulta ao registro está parada no momento. O pedido fica guardado; repita mais tarde. |
sem_navio | Nem nome nem número válidos foram enviados. |
pendente e indisponivel não são erro: a resposta é 200. Trate os dois como "ainda não verificado" e repita a mesma chamada depois. Não repita em laço curto: o resultado leva minutos, não segundos.Quando o número IMO enviado está no registro com outro nome, nome_difere vem true. Pode ser navio renomeado ou o número de outro navio, e vale conferir. Um número com o dígito verificador errado volta com imo_valido: false, não é consultado, e a conferência é feita pelo nome.
Um navio pelo número
curl "https://comexdoc.com.br/v1/navios/9312573" \ -H "Authorization: Bearer cxd_live_..."
Responde 404 quando o número não tem sete dígitos com o verificador certo, ou quando o navio ainda não está na base. No segundo caso, a consulta ao registro é pedida, e POST /v1/navios/verificar diz quando ela chegou.
Buscar
# por prefixo do número curl "https://comexdoc.com.br/v1/navios?q=93125" \ -H "Authorization: Bearer cxd_live_..." # por pedaço do nome curl "https://comexdoc.com.br/v1/navios?q=xin%20wei" \ -H "Authorization: Bearer cxd_live_..."
A busca olha os navios que a plataforma já validou no registro, e não o registro inteiro. Dígitos, com ou sem IMO na frente, são prefixo do número; texto é pedaço do nome. O campo interpretado_como diz como o termo foi lido. Para um navio que não aparece, use a conferência.
O que vem em cada navio
| Campo | O que é |
|---|---|
imo | Número IMO, sete dígitos |
nome | Nome atual no registro |
bandeira | País de registro, em inglês |
call_sign | Indicativo de chamada de rádio |
mmsi | Número do navio no AIS |
tipo | Tipo de navio, em inglês |
arqueacao_bruta | Arqueação bruta (gross tonnage) |
data_construcao | Ano e mês de construção, ou só o ano |
proprietario_registrado | Proprietário registrado |
proprietario_numero | Número IMO da empresa proprietária |
sancao_onu_navio | Situação do navio na lista de sanções da ONU |
sancao_onu_proprietario | Situação do proprietário ou operador na lista de sanções da ONU |
consultado_na_imo_em | Quando estes dados foram lidos do registro |
Os valores saem como o registro os escreve, em inglês. Campo que o registro não informa vem null.
Fonte
Os dados são do registro de navios da International Maritime Organization, e toda resposta diz isso no campo fonte. Bandeira e proprietário mudam: julgue a data em consultado_na_imo_em antes de confiar num dado antigo.