// docs

Casa dos Dados: Look up a company by CNPJ

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

casadosdados.com.br:pdp · 5 credits per request

Standard credit cost. Your account pricing is shown in the sandbox.

HTTP request

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"
}'

Keep your API key on your server. See the quickstart for authentication and response handling.

MCP request

The hosted MCP tool fixes target and type for this operation. Its remaining arguments use the same input rules as Extract.

POST /v1/mcp · Bearer or X-API-Key authentication

casadosdados_com_br_pdp · tools/call

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "casadosdados_com_br_pdp",
    "arguments": {
      "cnpj": "30.853.473/0001-00",
      "executionId": "exec_example_123"
    }
  }
}

Supported inputs

Conditional fields depend on the alternatives and constraints in the rule column. Fields marked unsupported are omitted.

Field	Type	Requirement	Rule	Default	Example
cnpj CNPJ used in Casa dos Dados PDP. The backend normalizes the score and queries the company by number.	string (14 digits)	Required	Brazilian CNPJ with 14 digits. Punctuation and masks are accepted and removed in the backend.	-	30.853.473/0001-00
target Target source for extraction.	enum	Required	Always mandatory in the payload and must be casadosdados.com.br.	-	casadosdados.com.br
type Extraction type: pdp, idp, plp, ilp, quote, review or places.	enum	Required	Always mandatory in the payload and must be pdp.	-	pdp

Request examples

Query by CNPJ

Enter CNPJ with or without punctuation. The backend normalizes the number, performs the search and opens the first detailed page with exact match.

Query by CNPJ

{
  "target": "casadosdados.com.br",
  "type": "pdp",
  "cnpj": "30.853.473/0001-00"
}

Response schema

Leaf paths and expected types. Field names and enum values are part of the API contract.

responseSchema

{
  "requestId": "string (uuid)",
  "executionId": "string (uuid)",
  "notFound": "boolean (optional; true when the upstream entity was not found and data is null)",
  "data.source": "string",
  "data.type": "string",
  "data.parser": "\"1.0.0\"",
  "data.cnpj": "string",
  "data.url": "string",
  "data.requestUrl": "string",
  "data.searchUrl": "string",
  "data.detailUrl": "string",
  "data.extractedAt": "string (iso datetime)",
  "data.searchTotal": "number",
  "data.matchedSearchResult.cnpj": "string",
  "data.matchedSearchResult.razao_social": "string",
  "data.matchedSearchResult.situacao_cadastral.situacao_atual": "string",
  "data.identifiedCompaniesCount": "number",
  "data.sameRegionCompanies[].cnpj": "string",
  "data.sameRegionCompanies[].razao_social": "string",
  "data.data.cnpj": "string",
  "data.data.razao_social": "string",
  "data.data.nome_fantasia": "string",
  "data.data.filial_numero": "number",
  "data.data.matriz_filial": "string",
  "data.data.situacao_cadastral.situacao_atual": "string",
  "data.data.endereco.municipio": "string",
  "data.data.endereco.uf": "string",
  "data.data.atividade_principal.codigo": "string",
  "data.data.atividade_principal.descricao": "string",
  "data.data.atividade_secundaria[].codigo": "string",
  "data.data.quadro_societario[].nome": "string",
  "data.data.contato_telefonico[].completo": "string",
  "data.data.contato_email[].email": "string",
  "data.data.simples.optante": "boolean",
  "data.data.mei.optante": "boolean",
  "data.data.versao": "string"
}

Example response

Illustrative response. Product names, reviews and other source content retain their original language. Missing and null values do not imply zero stock, free shipping or zero reviews.

responseExample

{
  "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"
    }
  }
}

Complete field reference

Path	Type	Description	Example
data.cnpj	string	CNPJ normalized (digits only) used in the query.	30853473000100
data.data.atividade_principal.codigo	string	Main code CNAE.	5611203
data.data.atividade_principal.descricao	string	Textual description of the main activity.	Lanchonetes, casas de chá, de sucos e similares
data.data.atividade_secundaria[].codigo	string	Code CNAE of a secondary activity.	4723700
data.data.cnpj	string	CNPJ of the company returned in the detailed payload.	30853473000100
data.data.contato_email[].email	string	Email address identified for the company.	CLAUCLAUNIC@HOTMAIL.COM
data.data.contato_telefonico[].completo	string	Full telephone number identified for the company.	41-992285958
data.data.endereco.municipio	string	Municipality of the registered address.	CURITIBA
data.data.endereco.uf	string	UF of the registered address.	PR
data.data.filial_numero	number	Branch number in the company registration.	1
data.data.matriz_filial	string	Indication of head office or branch.	MATRIZ
data.data.mei.optante	boolean	Indicates whether the company is listed as opting for MEI.	false
data.data.nome_fantasia	string	Trade name provided on the page, if applicable.
data.data.quadro_societario[].nome	string	Name of a partner or representative listed.	CLAUDIA NICOLAU
data.data.razao_social	string	Complete corporate name of the company.	ESTACAO RODO LANCHONETE LTDA
data.data.simples.optante	boolean	Indicates whether the company is listed as opting for Simples.	true
data.data.situacao_cadastral.situacao_atual	string	Current registration status of the company.	ATIVA
data.data.versao	string	Version of the payload displayed by the source.	v3
data.detailUrl	string	URL detailed resolved from the first exact search result.	https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100
data.extractedAt	string (iso datetime)	Extraction timestamp ISO.	2026-03-13T12:00:00.000Z
data.identifiedCompaniesCount	number	Aggregate counter displayed by the Casa dos Dados detail page.	70350113
data.matchedSearchResult.cnpj	string	CNPJ of the search result that exactly matched the query.	30853473000100
data.matchedSearchResult.razao_social	string	Social reason of the exact match found in the search.	ESTACAO RODO LANCHONETE LTDA
data.matchedSearchResult.situacao_cadastral.situacao_atual	string	Registration status of the result found during the search stage.	ATIVA
data.parser	"1.0.0"	Stable version of the API response format.	1.0.0
data.requestUrl	string	Same value as `data.url`; never exposes the queried internal endpoint.	https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100
data.sameRegionCompanies[].cnpj	string	CNPJ from a company listed in the same region as the page consulted.	65617434000180
data.sameRegionCompanies[].razao_social	string	Corporate name of a company listed in the same region.	65.617.434 MAMADU QUEBE JUNIOR
data.searchTotal	number	Total results returned in the search for Casa dos Dados.	1
data.searchUrl	string	URL search generated from the entered CNPJ.	https://casadosdados.com.br/solucao/cnpj?q=30853473000100
data.source	string	Extraction source.	casadosdados.com.br
data.type	string	Type of the operation returned.	pdp
data.url	string	URL canonical of the company detail page found.	https://casadosdados.com.br/solucao/cnpj/estacao-rodo-lanchonete-ltda-30853473000100
executionId	string (uuid)	ID single run used for deduplication and internal tracing.	66666666-2222-4222-8222-666666666666
notFound	boolean (optional; true when the upstream entity was not found and data is null)	Present and true when the upstream entity was not found. In this case data is null and the request still completes successfully.	N/A
requestId	string (uuid)	ID unique to the request HTTP.	66666666-1111-4111-8111-666666666666

Errors and missing data

When supported by this operation, an entity not found upstream can return HTTP 200 with data: null and notFound: true. Check the documented response fields before interpreting an empty result. Source-specific behavior and exceptions are described above.

HTTP status	Error code	Meaning
400	`INVALID_PAYLOAD`	Invalid JSON or a request that violates the documented validation rules.
401	`UNAUTHORIZED`	Missing authorization or an invalid API key or token.
402	`INSUFFICIENT_CREDITS`	The account has insufficient credits for this operation.
403	`FORBIDDEN`	The account does not have access, or the API is temporarily disabled.
409	`EXECUTION_CONFLICT`	The execution identifier conflicts with an incompatible execution state.
429	`RATE_LIMIT_EXCEEDED / TOO_MANY_INFLIGHT_REQUESTS`	A rate limit or simultaneous request limit was exceeded.
5xx	`UPSTREAM_TIMEOUT / UPSTREAM_HTTP_ERROR / WORKER_FUNCTION_ERROR`	An upstream, worker or gateway failure. Failed requests follow the platform refund policy.