Casa dos Dados
  1. v5
Casa dos Dados
  • Casa dos Dados - Documentação do sistema e API
  • Webhook
  • API
    • Informações Básicas
    • v4
      • Consulta CNPJ
        GET
      • Quantidade de empresas abertas do dia
        GET
      • Quantidade de empresas abertas nos últimos X dias
        GET
      • Consulta geração de arquivo
        GET
      • Listar solicitações de arquivos
        GET
    • v5
      • Pesquisa Avançada de empresas
        POST
      • Gerar arquivo com as empresas
        POST
      • Consulta o saldo total e detalhado da conta
        GET
  1. v5

Pesquisa Avançada de empresas

POST
https://api.casadosdados.com.br/v5/cnpj/pesquisa
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.casadosdados.com.br/v5/cnpj/pesquisa?tipo_resultado' \
--header 'Content-Type: application/json' \
--header 'api-key;' \
--data-raw '{
    "cnpj": [
        "29806217000175",
        "33000167000292"
    ],
    "busca_textual": [
        {
            "texto": [
                "string"
            ],
            "tipo_busca": "exata",
            "razao_social": true,
            "nome_fantasia": true,
            "nome_socio": true
        }
    ],
    "codigo_atividade_principal": [
        "7112000",
        "9602501",
        "6462000"
    ],
    "incluir_atividade_secundaria": true,
    "codigo_atividade_secundaria": [
        "7112000",
        "9602501",
        "6462000"
    ],
    "codigo_natureza_juridica": [
        "7112000",
        "9602501",
        "6462000"
    ],
    "situacao_cadastral": [
        "ATIVA"
    ],
    "matriz_filial": "MATRIZ",
    "cnpj_raiz": [
        "33000167",
        "29806217"
    ],
    "cep": [
        "07115000",
        "01310930"
    ],
    "endereco_numero": [
        "21",
        "109B"
    ],
    "uf": [
        "sp",
        "rj",
        "mg"
    ],
    "municipio": [
        "sao paulo",
        "guarulhos",
        "belo horizonte"
    ],
    "bairro": [
        "centro",
        "vila mariana"
    ],
    "ddd": [
        "11",
        "12",
        "31"
    ],
    "telefone": [
        "5135277255"
    ],
    "data_abertura": {
        "inicio": "2019-08-24",
        "fim": "2019-08-24",
        "ultimos_dias": 0
    },
    "capital_social": {
        "minimo": 0,
        "maximo": 0
    },
    "mei": {
        "optante": true,
        "excluir_optante": true
    },
    "simples": {
        "optante": true,
        "excluir_optante": true
    },
    "mais_filtros": {
        "somente_matriz": true,
        "somente_filial": true,
        "com_email": true,
        "com_telefone": true,
        "somente_fixo": true,
        "somente_celular": true,
        "excluir_empresas_visualizadas": true,
        "excluir_email_contab": true
    },
    "limite": 10,
    "pagina": 1
}'
Response Response Example
{
    "total": 0,
    "cnpjs": [
        {
            "cnpj": "33000167004794",
            "cnpj_raiz": "33000167",
            "filial_numero": 1,
            "razao_social": "PETROLEO BRASILEIRO S A PETROBRAS",
            "qualificacao_responsavel": {
                "codigo": "string",
                "descricao": "string"
            },
            "porte_empresa": {
                "codigo": "string",
                "descricao": "string"
            },
            "matriz_filial": "MATRIZ",
            "codigo_natureza_juridica": "string",
            "descricao_natureza_juridica": "string",
            "nome_fantasia": "string",
            "situacao_cadastral": {
                "situacao_cadastral": "string",
                "motivo": "string",
                "data": "2019-08-24"
            },
            "endereco": {
                "cep": "string",
                "tipo_logradouro": "string",
                "logradouro": "string",
                "numero": "string",
                "complemento": "string",
                "bairro": "string",
                "uf": "string",
                "municipio": "string",
                "ibge": {
                    "codigo_municipio": 0,
                    "codigo_uf": 0,
                    "latitude": 0,
                    "longitude": 0
                }
            },
            "data_abertura": "2019-08-24",
            "capital_social": 0,
            "situacao_especial": {
                "descricao": "string",
                "data": "2019-08-24"
            },
            "quadro_societario": [
                {
                    "nome": "string",
                    "qualificacao_socio": "string",
                    "qualificacao_socio_codigo": 0,
                    "identificador_socio": "string",
                    "documento": "string",
                    "data_entrada_sociedade": "2019-08-24",
                    "pais_socio": "string",
                    "cpf_representante_legal": "string",
                    "nome_representante_legal": "string",
                    "qualificacao_representante_legal": "string",
                    "faixa_etaria_codigo": 0,
                    "faixa_etaria_descricao": "string"
                }
            ]
        }
    ]
}

Requisição

Authorization
API Key
Adicionar parâmetro em header
api-key
Exemplo:
api-key: ********************
or
Parâmetros Query

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200OK
application/json
retorno com sucesso
Body

🟠400Pedido inválido
🟠401Não autorizado
🟠403Proibido
Modificado em 2025-07-16 18:32:15
Página anterior
Listar solicitações de arquivos
Próxima página
Gerar arquivo com as empresas
Built with