Referência da API › Tomadores
Listar tomadores
Lista os clientes (tomadores) cadastrados em uma empresa.
GET
/api/v1/empresas/{id}/tomadoresUse para encontrar um tomador antes de emitir, pelo documento, pelo código no seu sistema (id_externo) ou pelo nome. A lista é paginada.
Cada tomador pertence a uma única empresa: os clientes de uma empresa não aparecem para outra.
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
limitede 1 a 100 · Padrão:
50cursordocumentoid_externobuscaRespostas
200 Lista paginada
Campos da resposta
dadosdados[].idUUID
dados[].id_externoÚnico por empresa · até 100 caracteres
dados[].tipoValores:
pj, pf, estrangeirodados[].nome1 a 150 caracteres
dados[].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
dados[].nifaté 40 caracteres
dados[].motivo_sem_nifValores:
dispensado, nao_exigidodados[].emaildados[].telefonedados[].inscricao_municipalaté 15 caracteres
dados[].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.
dados[].endereco.cepFormato:
^[0-9]{8}$dados[].endereco.codigo_municipioFormato:
^[0-9]{7}$dados[].endereco.paisFormato:
^[A-Z]{2}$dados[].endereco.cidadedados[].endereco.codigo_postaldados[].endereco.estado_provincia_regiaodados[].endereco.logradourodados[].endereco.endereco_livredados[].endereco.numerodados[].endereco.bairrodados[].endereco.complementodados[].criada_emdata e hora ISO 8601
dados[].atualizada_emdata e hora ISO 8601
proximo_cursor404 Erro no formato padrão
Limites
Esta operação: 60 por minuto. Valem também os limites gerais da chave. Veja Limites de uso.

