Referência da API › Empresas
Listar empresas
Lista as empresas emitentes da organização, da mais recente para a mais antiga.
GET
/api/v1/empresasUse para encontrar o ID de uma empresa ou conferir quais estão ativas. A lista é paginada e aceita filtros que podem ser combinados, como CNPJ, empresa ativa ou inativa e busca pelo nome.
Parâmetros
limitede 1 a 100 · Padrão:
50cursorcnpjaté 18 caracteres
id_externoaté 100 caracteres
ativabuscaRazão social ou nome fantasia (2+ caracteres) · mínimo de 2 caracteres
Respostas
200 Lista paginada
Campos da resposta
dadosdados[].idUUID
dados[].id_externoaté 100 caracteres
dados[].cnpjCNPJ de 14 posições, numérico ou alfanumérico (12 posições 0-9/A-Z + 2 dígitos verificadores). Na entrada, máscara e minúsculas são aceitas e normalizadas; nas respostas vem sempre com 14 caracteres maiúsculos, sem máscara. · até 18 caracteres
dados[].razao_socialdados[].nome_fantasiadados[].inscricao_municipaldados[].emaildados[].telefonedados[].enderecodados[].endereco.cepdados[].endereco.logradourodados[].endereco.numerodados[].endereco.complementodados[].endereco.bairrodados[].endereco.codigo_municipioFormato:
^\d{7}$dados[].endereco.municipiodados[].endereco.ufdados[].ativadados[].criada_emdata e hora ISO 8601
dados[].atualizada_emdata e hora ISO 8601
proximo_cursor400 Erro no formato padrão
401 Chave ausente, inválida ou revogada
Limites
Esta operação: 60 por minuto. Valem também os limites gerais da chave. Veja Limites de uso.

