Referência da API › Tomadores
Consultar tomador
Devolve os dados de um tomador cadastrado na empresa.
GET
/api/v1/empresas/{id}/tomadores/{tomador_id}Use para conferir o cadastro antes de emitir uma nota para esse tomador. A resposta traz documento, nome, contato e endereço; tomador de outra empresa responde 404.
Parâmetros
idEmpresa da organização da chave (de outra organização → 404). UUID (RFC 9562); fora do padrão → 400 REQUISICAO_INVALIDA com campo id. · UUID
tomador_idUUID (RFC 9562). Fora do padrão: 400 REQUISICAO_INVALIDA com campo igual ao nome do parâmetro. · UUID
Respostas
200 Tomador
Campos da resposta
idUUID
id_externoÚnico por empresa · até 100 caracteres
tipoValores:
pj, pf, estrangeironome1 a 150 caracteres
documentoCPF (11 números) ou CNPJ (14 posições, numérico ou alfanumérico) com dígitos verificadores válidos; máscara e minúsculas são normalizadas · até 18 caracteres
nifaté 40 caracteres
motivo_sem_nifValores:
dispensado, nao_exigidoemailtelefoneinscricao_municipalaté 15 caracteres
enderecoNacional exige CEP/logradouro/número/bairro/IBGE. Exterior exige país/cidade/código postal/província/logradouro ou endereço livre/número/bairro. Complemento opcional.
endereco.cepFormato:
^[0-9]{8}$endereco.codigo_municipioFormato:
^[0-9]{7}$endereco.paisFormato:
^[A-Z]{2}$endereco.cidadeendereco.codigo_postalendereco.estado_provincia_regiaoendereco.logradouroendereco.endereco_livreendereco.numeroendereco.bairroendereco.complementocriada_emdata e hora ISO 8601
atualizada_emdata e hora ISO 8601
404 Erro no formato padrão
Limites
Valem também os limites gerais da chave. Veja Limites de uso.

