Skip to content
PT Start free

casadosdados.com.br

Casa dos Dados API

Query public Casa dos Dados data with GeckoAPI and receive structured JSON. Choose an operation to review its inputs, credit cost and response fields.

Extracts complete company registration data in Casa dos Dados from a CNPJ.

Try Casa dos Dados in the sandboxRead the API reference

GeckoAPI is independent of Casa dos Dados. This integration reads public data; it does not grant access to private accounts or account management operations.

Available operations

Look up a company by CNPJ

casadosdados.com.br:pdp

Extracts complete company registration data in Casa dos Dados from a CNPJ.

5 credits per request

DocumentationTry this operation

These are standard credit costs. Account-specific pricing is shown in the dashboard. Each operation has its own supported inputs and regional coverage.

Make your first request

The example uses look up a company by cnpj. Replace YOUR_API_KEY with your server-side API key. Copy supported inputs from the reference for the operation you choose.

Casa dos Dados · cURL 
curl -X POST https://api.geckoapi.com.br/v1/extract \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "target": "casadosdados.com.br",
  "type": "pdp",
  "cnpj": "30.853.473/0001-00"
}'

Example JSON response

Abbreviated example from the same operation. Arrays and nested objects are shortened here; the endpoint reference includes the full documented schema. Source content retains its original language.

Abbreviated response 
{
  "requestId": "66666666-1111-4111-8111-666666666666",
  "executionId": "66666666-2222-4222-8222-666666666666",
  "data": {
    "source": "casadosdados.com.br",
    "type": "pdp",
    "parser": "1.0.0",
    "cnpj": "30853473000100",
    "url": "https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100",
    "requestUrl": "https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100",
    "searchUrl": "https://casadosdados.com.br/solucao/cnpj?q=30853473000100",
    "detailUrl": "https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100",
    "extractedAt": "2026-03-13T12:00:00.000Z",
    "searchTotal": 1,
    "searchResults": [
      {
        "cnpj": "30853473000100",
        "razao_social": "ESTACAO RODO LANCHONETE LTDA",
        "nome_fantasia": "",
        "situacao_cadastral": {
          "situacao_atual": "ATIVA"
        }
      }
    ],
    "matchedSearchResult": {
      "cnpj": "30853473000100",
      "razao_social": "ESTACAO RODO LANCHONETE LTDA",
      "nome_fantasia": "",
      "situacao_cadastral": {
        "situacao_atual": "ATIVA"
      }
    },
    "identifiedCompaniesCount": 70350113,
    "sameRegionCompanies": [
      {
        "cnpj": "65617434000180",
        "razao_social": "65.617.434 MAMADU QUEBE JUNIOR",
        "nome_fantasia": ""
      }
    ],
    "data": {
      "cnpj": "30853473000100",
      "cnpj_raiz": "30853473",
      "filial_numero": 1,
      "razao_social": "ESTACAO RODO LANCHONETE LTDA",
      "nome_fantasia": "",
      "matriz_filial": "MATRIZ",
      "situacao_cadastral": {
        "situacao_atual": "ATIVA",
        "motivo": "SEM MOTIVO",
        "data": "2018-06-25T00:00:00Z"
      },
      "endereco": {
        "cep": "80060090",
        "logradouro": "AVENIDA PRESIDENTE AFFONSO CAMARGO",
        "numero": "330",
        "bairro": "JARDIM BOTANICO",
        "municipio": "CURITIBA",
        "uf": "PR"
      },
      "atividade_principal": {
        "codigo": "5611203",
        "descricao": "Lanchonetes, casas de chá, de sucos e similares"
      },
      "atividade_secundaria": [
        {
          "codigo": "4723700",
          "descricao": "Comércio varejista de bebidas"
        }
      ],
      "quadro_societario": [
        {
          "nome": "CLAUDIA NICOLAU",
          "qualificacao_socio": "Sócio-Administrador"
        }
      ],
      "contato_telefonico": [
        {
          "completo": "41-992285958",
          "ddd": "41",
          "numero": "992285958",
          "tipo": "celular"
        }
      ],
      "contato_email": [
        {
          "email": "CLAUCLAUNIC@HOTMAIL.COM",
          "valido": true,
          "dominio": "HOTMAIL.COM"
        }
      ],
      "simples": {
        "optante": true,
        "data_opcao_simples": "2018-06-25T00:00:00Z"
      },
      "mei": {
        "optante": false,
        "cpf": "37412564803"
      },
      "versao": "v3"
    }
  }
}
Explore the full response and field descriptions

Integrate with REST or MCP

Call POST /v1/extract from your backend, or use the operation-specific tool on POST /v1/mcp. The API reference includes both request formats. Keep credentials in your backend and handle missing fields, pagination and errors according to that operation's rules.

Authentication and getting started

Ready to test the Casa dos Dados API?

Open the documented example in the sandbox and inspect the response before integrating it into your application.

Try the APIPlans and credit pricing