{"openapi":"3.1.0","info":{"title":"PrismaData — CNPJ","version":"1.0.0","termsOfService":"https://prismadata.io/terms","contact":{"name":"PrismaData Support Team","url":"https://prismadata.io/contact","email":"suporte.api@prismadata.io"},"license":{"name":"Proprietary","url":"https://api.prismadata.io/license"},"description":"API de consulta de dados cadastrais e geocodificados de pessoas jurídicas brasileiras (CNPJ). A fonte primária é a base pública da Receita Federal, enriquecida com dados de geocodificação e sumarizações prontas para análise.\n\n## O que você recebe\n\n**Todos os ~60 milhões de CNPJs** publicados pela Receita Federal — ativos, suspensos, inaptos, baixados e nulos — atualizados na mesma cadência das publicações oficiais. Cada resposta traz `data_publicacao_rfb` e `data_processamento` para você auditar de qual versão dos dados o resultado veio.\n\nCada CNPJ retorna:\n\n- **Cadastro completo da RFB**: razão social, nome fantasia, situação cadastral, natureza jurídica, porte, capital social, opção pelo Simples e MEI, CNAE principal e secundários, endereço registrado.\n- **Sócios**: composição societária com identificação (PF, PJ ou estrangeiro), nome/razão social, qualificação, data de entrada, faixa etária. O CPF de sócios pessoa física vem **sempre mascarado** (por exemplo, `***.005.547-**`), em conformidade com a LGPD — nunca é retornado em formato completo.\n- **Geocodificação**: latitude, longitude, endereço normalizado, um score (0-100) e uma classificação de qualidade (`MUITO_ALTA`, `ALTA`, `MEDIA`, `BAIXA`, `MUITO_BAIXA`, `CENTROIDE_MUNICIPIO`, `NAO_GEOCODIFICADO`). Quando o endereço da RFB não pôde ser geocodificado, esses campos vêm `null` — o CNPJ continua consultável, apenas sem coordenadas.\n\n## Duas variantes de consulta\n\nCada endpoint tem duas versões que retornam **os mesmos dados de origem**, mudando só a forma:\n\n| Endpoint | Formato | Quando usar |\n|---|---|---|\n| `/cnpj/{cnpj}`, `/cnpj/batch`, `/cnpj/metadata` | **Consulta padrão** — sócios e CNAEs secundários vêm como agregações escalares (`total_socios`, `total_socios_pf`, `total_socios_pj`, `total_socios_estrangeiro`, `cnae_secundario_1..3`, `total_cnaes_secundarios`). Cada resultado tem exatamente 49 campos, todos escalares. | Análise em massa (DataFrame, planilha, BI). Formato ideal para pipelines de ciência de dados. |\n| `/cnpj/raw/{cnpj}`, `/cnpj/raw/batch`, `/cnpj/raw/metadata` | **Consulta detalhada** — sócios vêm como lista de objetos com todos os campos originais, e CNAEs secundários como lista de códigos. | Aplicações que precisam do detalhe de cada sócio ou de todos os CNAEs secundários (compliance, KYC, due diligence). |\n\n## Consulta enriquecida com dados geográficos\n\nOs endpoints `/cnpj/{cnpj}/enriched` (individual) e `/cnpj/batch/enriched` (em lote) combinam a consulta do CNPJ com **serviços de localização** da PrismaData em uma única chamada. Ative por parâmetros os enriquecimentos que você quer receber:\n\n- `slum` — proximidade e classificação de favelas\n- `prison` — proximidade e detalhes do presídio mais próximo\n- `border` — situação em relação a fronteiras internacionais\n- `personal_income_static` — renda média no ponto\n- `personal_income_pdf` — distribuição de renda no ponto\n- `commercial_cluster` — aglomerações comerciais próximas\n- `infosc` — informações do setor censitário\n- `tipologia` — tipologia CNEFE\n\nCada enriquecimento habilitado conta como uma consulta adicional para efeito de cota. Enriquecimentos solicitados para CNPJs sem coordenadas geocodificadas (`latitude` nula) **não são executados** e não contam.\n\n## Chamadas em lote\n\nOs endpoints em lote (`/cnpj/batch` e variantes) aceitam um body com a lista de CNPJs (`{\"cnpjs\":[...]}`) e retornam um objeto indexado pelo CNPJ. Valores `null` sinalizam CNPJs que não existem na base ou têm formato inválido — o restante do lote é processado normalmente.\n\nLimites por chamada:\n- `/cnpj/batch` (consulta padrão): **1024** CNPJs\n- `/cnpj/raw/batch` e `/cnpj/batch/enriched` (consultas com listas ou enriquecimentos): **256** CNPJs\n\n## CNPJ alfanumérico\n\nA API já suporta o novo formato **alfanumérico** de CNPJ que a Receita Federal passará a emitir (NT COCAD/SUARA 49/2024). Nos parâmetros de URL e nos bodies, você pode usar CNPJ com ou sem máscara, contendo dígitos e letras nas primeiras 12 posições e dígitos verificadores nas duas últimas.\n\n## Formato dos campos\n\nTodos os campos retornam com o prefixo `prismadata__pessoa_juridica__`, seguindo o padrão de nomes da PrismaData API. Os SDKs oficiais oferecem a opção de remover esse prefixo automaticamente.\n\nNos endpoints enriquecidos, os campos dos enriquecimentos habilitados ganham prefixos próprios (por exemplo, `prismadata__slum__` para favelas, `prismadata__border__` para fronteiras).\n\n## Mais informações\n\n- Detalhes comerciais, cobertura por região e planos: [prismadata.io/doc-comercial/cnpj](https://prismadata.io/doc-comercial/cnpj/)\n- Testes interativos: [prismadata.io/testador-de-api](https://prismadata.io/testador-de-api/)\n"},"servers":[{"url":"https://api.prismadata.io/v1","description":"Ambiente de Produção"}],"security":[{"X-Apikey":[]},{"api_key":[]},{"BearerAuth":[]}],"tags":[{"name":"CNPJ","description":"API de consulta de dados cadastrais e geocodificados de pessoas jurídicas brasileiras (CNPJ). A fonte primária é a base pública da Receita Federal, enriquecida com dados de geocodificação e sumarizações prontas para análise.\n\n## O que você recebe\n\n**Todos os ~60 milhões de CNPJs** publicados pela Receita Federal — ativos, suspensos, inaptos, baixados e nulos — atualizados na mesma cadência das publicações oficiais. Cada resposta traz `data_publicacao_rfb` e `data_processamento` para você auditar de qual versão dos dados o resultado veio.\n\nCada CNPJ retorna:\n\n- **Cadastro completo da RFB**: razão social, nome fantasia, situação cadastral, natureza jurídica, porte, capital social, opção pelo Simples e MEI, CNAE principal e secundários, endereço registrado.\n- **Sócios**: composição societária com identificação (PF, PJ ou estrangeiro), nome/razão social, qualificação, data de entrada, faixa etária. O CPF de sócios pessoa física vem **sempre mascarado** (por exemplo, `***.005.547-**`), em conformidade com a LGPD — nunca é retornado em formato completo.\n- **Geocodificação**: latitude, longitude, endereço normalizado, um score (0-100) e uma classificação de qualidade (`MUITO_ALTA`, `ALTA`, `MEDIA`, `BAIXA`, `MUITO_BAIXA`, `CENTROIDE_MUNICIPIO`, `NAO_GEOCODIFICADO`). Quando o endereço da RFB não pôde ser geocodificado, esses campos vêm `null` — o CNPJ continua consultável, apenas sem coordenadas.\n\n## Duas variantes de consulta\n\nCada endpoint tem duas versões que retornam **os mesmos dados de origem**, mudando só a forma:\n\n| Endpoint | Formato | Quando usar |\n|---|---|---|\n| `/cnpj/{cnpj}`, `/cnpj/batch`, `/cnpj/metadata` | **Consulta padrão** — sócios e CNAEs secundários vêm como agregações escalares (`total_socios`, `total_socios_pf`, `total_socios_pj`, `total_socios_estrangeiro`, `cnae_secundario_1..3`, `total_cnaes_secundarios`). Cada resultado tem exatamente 49 campos, todos escalares. | Análise em massa (DataFrame, planilha, BI). Formato ideal para pipelines de ciência de dados. |\n| `/cnpj/raw/{cnpj}`, `/cnpj/raw/batch`, `/cnpj/raw/metadata` | **Consulta detalhada** — sócios vêm como lista de objetos com todos os campos originais, e CNAEs secundários como lista de códigos. | Aplicações que precisam do detalhe de cada sócio ou de todos os CNAEs secundários (compliance, KYC, due diligence). |\n\n## Consulta enriquecida com dados geográficos\n\nOs endpoints `/cnpj/{cnpj}/enriched` (individual) e `/cnpj/batch/enriched` (em lote) combinam a consulta do CNPJ com **serviços de localização** da PrismaData em uma única chamada. Ative por parâmetros os enriquecimentos que você quer receber:\n\n- `slum` — proximidade e classificação de favelas\n- `prison` — proximidade e detalhes do presídio mais próximo\n- `border` — situação em relação a fronteiras internacionais\n- `personal_income_static` — renda média no ponto\n- `personal_income_pdf` — distribuição de renda no ponto\n- `commercial_cluster` — aglomerações comerciais próximas\n- `infosc` — informações do setor censitário\n- `tipologia` — tipologia CNEFE\n\nCada enriquecimento habilitado conta como uma consulta adicional para efeito de cota. Enriquecimentos solicitados para CNPJs sem coordenadas geocodificadas (`latitude` nula) **não são executados** e não contam.\n\n## Chamadas em lote\n\nOs endpoints em lote (`/cnpj/batch` e variantes) aceitam um body com a lista de CNPJs (`{\"cnpjs\":[...]}`) e retornam um objeto indexado pelo CNPJ. Valores `null` sinalizam CNPJs que não existem na base ou têm formato inválido — o restante do lote é processado normalmente.\n\nLimites por chamada:\n- `/cnpj/batch` (consulta padrão): **1024** CNPJs\n- `/cnpj/raw/batch` e `/cnpj/batch/enriched` (consultas com listas ou enriquecimentos): **256** CNPJs\n\n## CNPJ alfanumérico\n\nA API já suporta o novo formato **alfanumérico** de CNPJ que a Receita Federal passará a emitir (NT COCAD/SUARA 49/2024). Nos parâmetros de URL e nos bodies, você pode usar CNPJ com ou sem máscara, contendo dígitos e letras nas primeiras 12 posições e dígitos verificadores nas duas últimas.\n\n## Formato dos campos\n\nTodos os campos retornam com o prefixo `prismadata__pessoa_juridica__`, seguindo o padrão de nomes da PrismaData API. Os SDKs oficiais oferecem a opção de remover esse prefixo automaticamente.\n\nNos endpoints enriquecidos, os campos dos enriquecimentos habilitados ganham prefixos próprios (por exemplo, `prismadata__slum__` para favelas, `prismadata__border__` para fronteiras).\n\n## Mais informações\n\n- Detalhes comerciais, cobertura por região e planos: [prismadata.io/doc-comercial/cnpj](https://prismadata.io/doc-comercial/cnpj/)\n- Testes interativos: [prismadata.io/testador-de-api](https://prismadata.io/testador-de-api/)\n"}],"paths":{"/cnpj/raw/metadata":{"get":{"tags":["CNPJ"],"summary":"Versão e cobertura da base CNPJ (formato aninhado)","description":"Metadata cru com cobertura_geo aninhada.","operationId":"consulta_metadata_raw_cnpj_raw_metadata_get","responses":{"200":{"description":"Metadados da versao atual dos dados (cobertura por classe de qualidade geografica como objeto aninhado).","content":{"application/json":{"schema":{"description":"Metadados da versao atual dos dados (formato detalhado).","properties":{"prismadata__pessoa_juridica__versao_dados":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Versao do dataset atual (`YYYYMMDD`).","title":"Prismadata  Pessoa Juridica  Versao Dados"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data da publicacao dos dados pela Receita Federal.","title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data e hora do enriquecimento dos dados.","title":"Prismadata  Pessoa Juridica  Data Processamento"},"prismadata__pessoa_juridica__total_cnpjs_carregados":{"description":"Total de CNPJs disponiveis na versao atual.","title":"Prismadata  Pessoa Juridica  Total Cnpjs Carregados","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo":{"additionalProperties":{"type":"integer"},"description":"Objeto com a distribuicao dos CNPJs por classe de qualidade da geocodificacao.","title":"Prismadata  Pessoa Juridica  Cobertura Geo","type":"object"},"prismadata__pessoa_juridica__historico_competencia_min":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competencia mais antiga carregada na serie historica (`YYYY-MM-DD`).","title":"Prismadata  Pessoa Juridica  Historico Competencia Min"},"prismadata__pessoa_juridica__historico_competencia_max":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competencia mais recente carregada na serie historica (`YYYY-MM-DD`).","title":"Prismadata  Pessoa Juridica  Historico Competencia Max"},"prismadata__pessoa_juridica__historico_total_competencias":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Total de competencias mensais distintas presentes na serie.","title":"Prismadata  Pessoa Juridica  Historico Total Competencias"},"prismadata__pessoa_juridica__historico_competencias_ausentes":{"description":"Competencias que faltam entre `competencia_min` e `competencia_max` (ex.: `[\"2025-01-01\"]`). Ausencias declaradas — se lista vazia, cobertura completa.","items":{"type":"string"},"title":"Prismadata  Pessoa Juridica  Historico Competencias Ausentes","type":"array"}},"required":["prismadata__pessoa_juridica__total_cnpjs_carregados","prismadata__pessoa_juridica__cobertura_geo"],"title":"MetadataRawResponse","type":"object"},"example":{"prismadata__pessoa_juridica__versao_dados":"20260301","prismadata__pessoa_juridica__data_publicacao_rfb":"2026-03-01","prismadata__pessoa_juridica__data_processamento":"2026-06-24T12:51:48Z","prismadata__pessoa_juridica__total_cnpjs_carregados":800,"prismadata__pessoa_juridica__cobertura_geo":{"MUITO_ALTA":371,"ALTA":116,"MEDIA":254,"BAIXA":51,"MUITO_BAIXA":8,"NAO_GEOCODIFICADO":0,"SEM_GEO":0}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.prismadata.io/v1/cnpj/raw/metadata\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\""},{"lang":"Python","source":"import httpx\n\nresp = httpx.get(\n    \"https://api.prismadata.io/v1/cnpj/raw/metadata\",\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nmeta = client.cnpj_raw_metadata()\nprint(meta[\"prismadata__pessoa_juridica__cobertura_geo\"])"}]}},"/cnpj/raw/batch":{"post":{"tags":["CNPJ"],"summary":"Dados cadastrais completos de CNPJs em lote","description":"Lote raw. OUTPUT eh dict {cnpj: CnpjF1_completo ou null}.","operationId":"consulta_lote_raw_cnpj_raw_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoteRequest"}}},"required":true},"responses":{"200":{"description":"Dicionario indexado pelo CNPJ com dados completos. Valor `null` para CNPJs invalidos ou nao encontrados. Limite: 256 CNPJs por chamada.","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"$ref":"#/components/schemas/PessoaJuridicaRawResponse"},{"type":"null"}]},"description":"Resultado da consulta detalhada em lote: dicionario indexado pelo CNPJ.","title":"BatchRawResponse","type":"object"},"example":{"82554437000131":{"prismadata__pessoa_juridica__bairro":"MERCES","prismadata__pessoa_juridica__capital_social":"500000.00","prismadata__pessoa_juridica__cep":"80810000","prismadata__pessoa_juridica__cnae_principal_codigo":"6141800","prismadata__pessoa_juridica__cnae_principal_descricao":"","prismadata__pessoa_juridica__cnaes_secundarios":["6110803","6190699","6190601","4752100","6204000"],"prismadata__pessoa_juridica__cnpj":"82554437000131","prismadata__pessoa_juridica__cnpj_alfanumerico":false,"prismadata__pessoa_juridica__cnpj_basico":"82554437","prismadata__pessoa_juridica__cnpj_dv":"31","prismadata__pessoa_juridica__cnpj_ordem":"0001","prismadata__pessoa_juridica__data_abertura":"1991-06-18","prismadata__pessoa_juridica__data_processamento":"2026-06-24T12:51:48Z","prismadata__pessoa_juridica__data_publicacao_rfb":"2026-03-01","prismadata__pessoa_juridica__data_situacao_cadastral":"2005-11-03","prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":false,"prismadata__pessoa_juridica__endereco_existe":true,"prismadata__pessoa_juridica__endereco_normalizado":"AVENIDA MANOEL RIBAS, 2447 - MERCES, CURITIBA - PR, 80810-002","prismadata__pessoa_juridica__id_loc":6604984264422369595,"prismadata__pessoa_juridica__id_logradouro":8339738480598698066,"prismadata__pessoa_juridica__latitude":"-25.415493","prismadata__pessoa_juridica__logradouro":"MANOEL RIBAS","prismadata__pessoa_juridica__longitude":"-49.298817","prismadata__pessoa_juridica__matriz_filial":"MATRIZ","prismadata__pessoa_juridica__motivo_situacao_cadastral":"SEM MOTIVO","prismadata__pessoa_juridica__municipio_codigo":"0007535","prismadata__pessoa_juridica__municipio_nome":"CURITIBA","prismadata__pessoa_juridica__natureza_juridica_codigo":"2062","prismadata__pessoa_juridica__natureza_juridica_descricao":"Sociedade Empresária Limitada","prismadata__pessoa_juridica__nome_fantasia":"BARIGUI TELECOM","prismadata__pessoa_juridica__numero":"2447","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":"ALTA","prismadata__pessoa_juridica__qualidade_geocodificacao_score":100,"prismadata__pessoa_juridica__razao_social":"TV BARIGUI LTDA","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__socios":[{"prismadata__pessoa_juridica__cnpj_cpf_socio":"***.005.547-**","prismadata__pessoa_juridica__data_entrada":"2002-11-28","prismadata__pessoa_juridica__faixa_etaria":"51-60","prismadata__pessoa_juridica__identificador_socio":"PF","prismadata__pessoa_juridica__nome_ou_razao_social":"ROBES SOLEI ROCHA","prismadata__pessoa_juridica__qualificacao_codigo":"49","prismadata__pessoa_juridica__qualificacao_descricao":"Sócio-Administrador"}],"prismadata__pessoa_juridica__uf":"PR"}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl -X POST \"https://api.prismadata.io/v1/cnpj/raw/batch\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }'"},{"lang":"Python","source":"import httpx\n\nresp = httpx.post(\n    \"https://api.prismadata.io/v1/cnpj/raw/batch\",\n    json={...},\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nresult = client.cnpj_raw_batch([\"82554437000131\"])\nprint(result)"}]}},"/cnpj/raw/{cnpj}":{"get":{"tags":["CNPJ"],"summary":"Dados cadastrais completos de um CNPJ, com sócios e CNAEs","description":"Lookup raw — CnpjF1 completo com socios + cnaes_secundarios.","operationId":"consulta_cnpj_raw_cnpj_raw__cnpj__get","parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"CNPJ com ou sem mascara (alfanumerico aceito)","title":"Cnpj"},"description":"CNPJ com ou sem mascara (alfanumerico aceito)"}],"responses":{"200":{"description":"Dados do CNPJ na consulta detalhada (com lista completa de socios e CNAEs).","content":{"application/json":{"schema":{"description":"Dados de um CNPJ na consulta detalhada (com lista completa de socios e CNAEs).","properties":{"prismadata__pessoa_juridica__cnpj":{"description":"CNPJ de 14 caracteres, sem mascara.","title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__cnpj_ordem":{"title":"Prismadata  Pessoa Juridica  Cnpj Ordem","type":"string"},"prismadata__pessoa_juridica__cnpj_dv":{"title":"Prismadata  Pessoa Juridica  Cnpj Dv","type":"string"},"prismadata__pessoa_juridica__cnpj_alfanumerico":{"title":"Prismadata  Pessoa Juridica  Cnpj Alfanumerico","type":"boolean"},"prismadata__pessoa_juridica__matriz_filial":{"title":"Prismadata  Pessoa Juridica  Matriz Filial","type":"string"},"prismadata__pessoa_juridica__razao_social":{"title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Nome Fantasia"},"prismadata__pessoa_juridica__situacao_cadastral":{"title":"Prismadata  Pessoa Juridica  Situacao Cadastral","type":"string"},"prismadata__pessoa_juridica__data_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Situacao Cadastral"},"prismadata__pessoa_juridica__motivo_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Motivo Situacao Cadastral"},"prismadata__pessoa_juridica__data_abertura":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Abertura"},"prismadata__pessoa_juridica__natureza_juridica_codigo":{"title":"Prismadata  Pessoa Juridica  Natureza Juridica Codigo","type":"string"},"prismadata__pessoa_juridica__natureza_juridica_descricao":{"title":"Prismadata  Pessoa Juridica  Natureza Juridica Descricao","type":"string"},"prismadata__pessoa_juridica__porte":{"title":"Prismadata  Pessoa Juridica  Porte","type":"string"},"prismadata__pessoa_juridica__capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Capital Social"},"prismadata__pessoa_juridica__opcao_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Opcao Simples"},"prismadata__pessoa_juridica__data_opcao_simples":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Opcao Simples"},"prismadata__pessoa_juridica__opcao_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Opcao Mei"},"prismadata__pessoa_juridica__data_opcao_mei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Opcao Mei"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo","type":"string"},"prismadata__pessoa_juridica__cnae_principal_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Cnae Principal Descricao"},"prismadata__pessoa_juridica__cnaes_secundarios":{"description":"Lista completa de codigos CNAE secundarios.","items":{"type":"string"},"title":"Prismadata  Pessoa Juridica  Cnaes Secundarios","type":"array"},"prismadata__pessoa_juridica__logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Logradouro"},"prismadata__pessoa_juridica__numero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Numero"},"prismadata__pessoa_juridica__complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Complemento"},"prismadata__pessoa_juridica__bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Bairro"},"prismadata__pessoa_juridica__municipio_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Municipio Codigo"},"prismadata__pessoa_juridica__municipio_nome":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Municipio Nome"},"prismadata__pessoa_juridica__uf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Uf"},"prismadata__pessoa_juridica__cep":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Cep"},"prismadata__pessoa_juridica__id_logradouro":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Id Logradouro"},"prismadata__pessoa_juridica__id_loc":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Id Loc"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__endereco_normalizado":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Endereco Normalizado"},"prismadata__pessoa_juridica__qualidade_geocodificacao_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Score"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"},"prismadata__pessoa_juridica__endereco_existe":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Endereco Existe"},"prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Divergencia Endereco Rfb Geocoder"},"prismadata__pessoa_juridica__socios":{"description":"Lista completa de socios com todos os campos originais.","items":{"$ref":"#/components/schemas/SocioPublico"},"title":"Prismadata  Pessoa Juridica  Socios","type":"array"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Processamento"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__cnpj_ordem","prismadata__pessoa_juridica__cnpj_dv","prismadata__pessoa_juridica__cnpj_alfanumerico","prismadata__pessoa_juridica__matriz_filial","prismadata__pessoa_juridica__razao_social","prismadata__pessoa_juridica__situacao_cadastral","prismadata__pessoa_juridica__natureza_juridica_codigo","prismadata__pessoa_juridica__natureza_juridica_descricao","prismadata__pessoa_juridica__porte","prismadata__pessoa_juridica__cnae_principal_codigo","prismadata__pessoa_juridica__cnaes_secundarios","prismadata__pessoa_juridica__socios"],"title":"PessoaJuridicaRawResponse","type":"object"},"example":{"prismadata__pessoa_juridica__bairro":"MERCES","prismadata__pessoa_juridica__capital_social":"500000.00","prismadata__pessoa_juridica__cep":"80810000","prismadata__pessoa_juridica__cnae_principal_codigo":"6141800","prismadata__pessoa_juridica__cnae_principal_descricao":"","prismadata__pessoa_juridica__cnaes_secundarios":["6110803","6190699","6190601","4752100","6204000"],"prismadata__pessoa_juridica__cnpj":"82554437000131","prismadata__pessoa_juridica__cnpj_alfanumerico":false,"prismadata__pessoa_juridica__cnpj_basico":"82554437","prismadata__pessoa_juridica__cnpj_dv":"31","prismadata__pessoa_juridica__cnpj_ordem":"0001","prismadata__pessoa_juridica__data_abertura":"1991-06-18","prismadata__pessoa_juridica__data_processamento":"2026-06-24T12:51:48Z","prismadata__pessoa_juridica__data_publicacao_rfb":"2026-03-01","prismadata__pessoa_juridica__data_situacao_cadastral":"2005-11-03","prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":false,"prismadata__pessoa_juridica__endereco_existe":true,"prismadata__pessoa_juridica__endereco_normalizado":"AVENIDA MANOEL RIBAS, 2447 - MERCES, CURITIBA - PR, 80810-002","prismadata__pessoa_juridica__id_loc":6604984264422369595,"prismadata__pessoa_juridica__id_logradouro":8339738480598698066,"prismadata__pessoa_juridica__latitude":"-25.415493","prismadata__pessoa_juridica__logradouro":"MANOEL RIBAS","prismadata__pessoa_juridica__longitude":"-49.298817","prismadata__pessoa_juridica__matriz_filial":"MATRIZ","prismadata__pessoa_juridica__motivo_situacao_cadastral":"SEM MOTIVO","prismadata__pessoa_juridica__municipio_codigo":"0007535","prismadata__pessoa_juridica__municipio_nome":"CURITIBA","prismadata__pessoa_juridica__natureza_juridica_codigo":"2062","prismadata__pessoa_juridica__natureza_juridica_descricao":"Sociedade Empresária Limitada","prismadata__pessoa_juridica__nome_fantasia":"BARIGUI TELECOM","prismadata__pessoa_juridica__numero":"2447","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":"ALTA","prismadata__pessoa_juridica__qualidade_geocodificacao_score":100,"prismadata__pessoa_juridica__razao_social":"TV BARIGUI LTDA","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__socios":[{"prismadata__pessoa_juridica__cnpj_cpf_socio":"***.005.547-**","prismadata__pessoa_juridica__data_entrada":"2002-11-28","prismadata__pessoa_juridica__faixa_etaria":"51-60","prismadata__pessoa_juridica__identificador_socio":"PF","prismadata__pessoa_juridica__nome_ou_razao_social":"ROBES SOLEI ROCHA","prismadata__pessoa_juridica__qualificacao_codigo":"49","prismadata__pessoa_juridica__qualificacao_descricao":"Sócio-Administrador"}],"prismadata__pessoa_juridica__uf":"PR"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.prismadata.io/v1/cnpj/raw/{cnpj}\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\""},{"lang":"Python","source":"import httpx\n\nresp = httpx.get(\n    \"https://api.prismadata.io/v1/cnpj/raw/{cnpj}\",\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nresult = client.cnpj_raw(\"82554437000131\")\nfor socio in result[\"prismadata__pessoa_juridica__socios\"]:\n    print(socio[\"prismadata__pessoa_juridica__nome_ou_razao_social\"])"}]}},"/cnpj/metadata":{"get":{"tags":["CNPJ"],"summary":"Versão e cobertura da base CNPJ (formato plano)","description":"Metadata flat (cobertura_geo achatada por classe).","operationId":"consulta_metadata_flat_cnpj_metadata_get","responses":{"200":{"description":"Metadados da versao atual dos dados (cobertura por classe de qualidade geografica em campos escalares).","content":{"application/json":{"schema":{"description":"Metadados da versao atual dos dados (formato padrao).","properties":{"prismadata__pessoa_juridica__versao_dados":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Versao do dataset atual (`YYYYMMDD`).","title":"Prismadata  Pessoa Juridica  Versao Dados"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data da publicacao dos dados pela Receita Federal.","title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data e hora do enriquecimento dos dados.","title":"Prismadata  Pessoa Juridica  Data Processamento"},"prismadata__pessoa_juridica__total_cnpjs_carregados":{"description":"Total de CNPJs disponiveis na versao atual.","title":"Prismadata  Pessoa Juridica  Total Cnpjs Carregados","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_muito_alta":{"description":"CNPJs com qualidade de geocodificacao muito alta.","title":"Prismadata  Pessoa Juridica  Cobertura Geo Muito Alta","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_alta":{"description":"CNPJs com qualidade de geocodificacao alta.","title":"Prismadata  Pessoa Juridica  Cobertura Geo Alta","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_media":{"description":"CNPJs com qualidade de geocodificacao media.","title":"Prismadata  Pessoa Juridica  Cobertura Geo Media","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_baixa":{"description":"CNPJs com qualidade de geocodificacao baixa.","title":"Prismadata  Pessoa Juridica  Cobertura Geo Baixa","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_muito_baixa":{"description":"CNPJs com qualidade de geocodificacao muito baixa.","title":"Prismadata  Pessoa Juridica  Cobertura Geo Muito Baixa","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_centroide_municipio":{"description":"CNPJs projetados no centroide do municipio (endereco nao resolvido pra logradouro/numero — introduzido em v20260701).","title":"Prismadata  Pessoa Juridica  Cobertura Geo Centroide Municipio","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_nao_geocodificado":{"description":"CNPJs sem geocodificacao (chave `(logradouro, numero, bairro, cep, municipio, uf)` nao presente no cache do geocoder externo — cache miss, nao erro semantico).","title":"Prismadata  Pessoa Juridica  Cobertura Geo Nao Geocodificado","type":"integer"},"prismadata__pessoa_juridica__cobertura_geo_sem_geo":{"description":"CNPJs sem classificacao de qualidade atribuida.","title":"Prismadata  Pessoa Juridica  Cobertura Geo Sem Geo","type":"integer"},"prismadata__pessoa_juridica__historico_competencia_min":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competencia mais antiga carregada na serie historica (`YYYY-MM-DD`).","title":"Prismadata  Pessoa Juridica  Historico Competencia Min"},"prismadata__pessoa_juridica__historico_competencia_max":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Competencia mais recente carregada na serie historica (`YYYY-MM-DD`).","title":"Prismadata  Pessoa Juridica  Historico Competencia Max"},"prismadata__pessoa_juridica__historico_total_competencias":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Total de competencias mensais distintas presentes na serie.","title":"Prismadata  Pessoa Juridica  Historico Total Competencias"},"prismadata__pessoa_juridica__historico_competencias_ausentes":{"description":"Competencias faltantes entre min e max (ex.: `[\"2025-01-01\"]`).","items":{"type":"string"},"title":"Prismadata  Pessoa Juridica  Historico Competencias Ausentes","type":"array"}},"required":["prismadata__pessoa_juridica__total_cnpjs_carregados","prismadata__pessoa_juridica__cobertura_geo_muito_alta","prismadata__pessoa_juridica__cobertura_geo_alta","prismadata__pessoa_juridica__cobertura_geo_media","prismadata__pessoa_juridica__cobertura_geo_baixa","prismadata__pessoa_juridica__cobertura_geo_muito_baixa","prismadata__pessoa_juridica__cobertura_geo_centroide_municipio","prismadata__pessoa_juridica__cobertura_geo_nao_geocodificado","prismadata__pessoa_juridica__cobertura_geo_sem_geo"],"title":"MetadataFlatResponse","type":"object"},"example":{"prismadata__pessoa_juridica__versao_dados":"20260301","prismadata__pessoa_juridica__data_publicacao_rfb":"2026-03-01","prismadata__pessoa_juridica__data_processamento":"2026-06-24T12:51:48Z","prismadata__pessoa_juridica__total_cnpjs_carregados":800,"prismadata__pessoa_juridica__cobertura_geo_muito_alta":371,"prismadata__pessoa_juridica__cobertura_geo_alta":116,"prismadata__pessoa_juridica__cobertura_geo_media":254,"prismadata__pessoa_juridica__cobertura_geo_baixa":51,"prismadata__pessoa_juridica__cobertura_geo_muito_baixa":8,"prismadata__pessoa_juridica__cobertura_geo_nao_geocodificado":0,"prismadata__pessoa_juridica__cobertura_geo_sem_geo":0}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.prismadata.io/v1/cnpj/metadata\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\""},{"lang":"Python","source":"import httpx\n\nresp = httpx.get(\n    \"https://api.prismadata.io/v1/cnpj/metadata\",\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nmeta = client.cnpj_metadata()\nprint(meta[\"prismadata__pessoa_juridica__total_cnpjs_carregados\"])"}]}},"/cnpj/batch":{"post":{"tags":["CNPJ"],"summary":"Dados cadastrais de CNPJs em lote (formato plano)","description":"Lote flat. OUTPUT eh dict {cnpj: CnpjF1Flat ou null}.","operationId":"consulta_lote_flat_cnpj_batch_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/LoteRequest"}}},"required":true},"responses":{"200":{"description":"Dicionario indexado pelo CNPJ. Valor `null` para CNPJs invalidos ou nao encontrados. Limite: 1024 CNPJs por chamada.","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"$ref":"#/components/schemas/PessoaJuridicaFlatResponse"},{"type":"null"}]},"description":"Resultado da consulta padrao em lote: dicionario indexado pelo CNPJ.","title":"BatchFlatResponse","type":"object"},"example":{"82554437000131":{"prismadata__pessoa_juridica__bairro":"MERCES","prismadata__pessoa_juridica__capital_social":"500000.00","prismadata__pessoa_juridica__cep":"80810000","prismadata__pessoa_juridica__cnae_principal_codigo":"6141800","prismadata__pessoa_juridica__cnae_principal_descricao":"","prismadata__pessoa_juridica__cnae_secundario_1":"6110803","prismadata__pessoa_juridica__cnae_secundario_2":"6190699","prismadata__pessoa_juridica__cnae_secundario_3":"6190601","prismadata__pessoa_juridica__cnpj":"82554437000131","prismadata__pessoa_juridica__cnpj_alfanumerico":false,"prismadata__pessoa_juridica__cnpj_basico":"82554437","prismadata__pessoa_juridica__cnpj_dv":"31","prismadata__pessoa_juridica__cnpj_ordem":"0001","prismadata__pessoa_juridica__data_abertura":"1991-06-18","prismadata__pessoa_juridica__data_processamento":"2026-06-24T12:51:48Z","prismadata__pessoa_juridica__data_publicacao_rfb":"2026-03-01","prismadata__pessoa_juridica__data_situacao_cadastral":"2005-11-03","prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":false,"prismadata__pessoa_juridica__endereco_existe":true,"prismadata__pessoa_juridica__endereco_normalizado":"AVENIDA MANOEL RIBAS, 2447 - MERCES, CURITIBA - PR, 80810-002","prismadata__pessoa_juridica__id_loc":6604984264422369595,"prismadata__pessoa_juridica__id_logradouro":8339738480598698066,"prismadata__pessoa_juridica__latitude":"-25.415493","prismadata__pessoa_juridica__logradouro":"MANOEL RIBAS","prismadata__pessoa_juridica__longitude":"-49.298817","prismadata__pessoa_juridica__matriz_filial":"MATRIZ","prismadata__pessoa_juridica__motivo_situacao_cadastral":"SEM MOTIVO","prismadata__pessoa_juridica__municipio_codigo":"0007535","prismadata__pessoa_juridica__municipio_nome":"CURITIBA","prismadata__pessoa_juridica__natureza_juridica_codigo":"2062","prismadata__pessoa_juridica__natureza_juridica_descricao":"Sociedade Empresária Limitada","prismadata__pessoa_juridica__nome_fantasia":"BARIGUI TELECOM","prismadata__pessoa_juridica__numero":"2447","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":"ALTA","prismadata__pessoa_juridica__qualidade_geocodificacao_score":100,"prismadata__pessoa_juridica__razao_social":"TV BARIGUI LTDA","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__total_cnaes_secundarios":5,"prismadata__pessoa_juridica__total_socios":1,"prismadata__pessoa_juridica__total_socios_estrangeiro":0,"prismadata__pessoa_juridica__total_socios_pf":1,"prismadata__pessoa_juridica__total_socios_pj":0,"prismadata__pessoa_juridica__uf":"PR"}}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl -X POST \"https://api.prismadata.io/v1/cnpj/batch\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }'"},{"lang":"Python","source":"import httpx\n\nresp = httpx.post(\n    \"https://api.prismadata.io/v1/cnpj/batch\",\n    json={...},\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nresult = client.cnpj_batch([\"82554437000131\", \"60701190076771\"])\nprint(result)"}]}},"/cnpj/{cnpj}/historico/socios":{"get":{"tags":["CNPJ"],"summary":"Histórico do quadro societário de um CNPJ","description":"Trajetoria QSA: todas as versoes de cada socio do CNPJ.\n\nCada linha = 1 socio em 1 janela `[valido_de, valido_ate)`. `valido_ate =\n9999-12-31` indica versao vigente. Ordem: cronologica ASC, entao\nalfabetica por nome. `cnpj_cpf_socio` vem formatado (`***.XXX.XXX-**`\npara PF, `XX.XXX.XXX/XXXX-XX` para PJ, null para ESTRANGEIRO).","operationId":"consulta_historico_socios_cnpj__cnpj__historico_socios_get","parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"CNPJ com ou sem mascara","title":"Cnpj"},"description":"CNPJ com ou sem mascara"}],"responses":{"200":{"description":"Trajetoria do QSA (quadro societario). Uma linha por (socio, intervalo temporal). Socios PF vem com CPF mascarado.","content":{"application/json":{"schema":{"description":"Trajetoria do QSA. Uma linha por (socio, periodo de validade `[valido_de, valido_ate)`).","properties":{"prismadata__pessoa_juridica__cnpj":{"title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__versoes":{"description":"Uma linha por (socio, intervalo temporal). Ordenacao ASC por `valido_de`.","items":{"$ref":"#/components/schemas/VersaoSocioPublica"},"title":"Prismadata  Pessoa Juridica  Versoes","type":"array"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__versoes"],"title":"HistoricoSociosResponse","type":"object"},"example":{"prismadata__pessoa_juridica__cnpj":"33000167000101","prismadata__pessoa_juridica__cnpj_basico":"33000167","prismadata__pessoa_juridica__versoes":[{"prismadata__pessoa_juridica__valido_de":"2023-05-01","prismadata__pessoa_juridica__valido_ate":"9999-12-31","prismadata__pessoa_juridica__identificador_socio":"PF","prismadata__pessoa_juridica__nome_ou_razao_social":"CARLOS AUGUSTO BURGOS BARRETO","prismadata__pessoa_juridica__cnpj_cpf_socio":"***.001.331-**","prismadata__pessoa_juridica__qualificacao_codigo":"10","prismadata__pessoa_juridica__qualificacao_descricao":"Diretor","prismadata__pessoa_juridica__data_entrada":"2023-04-17"}]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.prismadata.io/v1/cnpj/{cnpj}/historico/socios\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\""},{"lang":"Python","source":"import httpx\n\nresp = httpx.get(\n    \"https://api.prismadata.io/v1/cnpj/{cnpj}/historico/socios\",\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"}]}},"/cnpj/{cnpj}/historico":{"get":{"tags":["CNPJ"],"summary":"Histórico cadastral de um CNPJ","description":"Trajetoria cadastral: todas as versoes escalares do CNPJ.\n\nCada linha = 1 versao com `[valido_de, valido_ate)`. `valido_ate =\n9999-12-31` indica versao vigente. Ordem cronologica ASC. QSA (socios)\nNAO vem nesta resposta — consulte `/cnpj/{cnpj}/historico/socios`.","operationId":"consulta_historico_cadastral_cnpj__cnpj__historico_get","parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"CNPJ com ou sem mascara","title":"Cnpj"},"description":"CNPJ com ou sem mascara"}],"responses":{"200":{"description":"Trajetoria cadastral do CNPJ (versoes ao longo do tempo). Ordem cronologica ASC. `valido_ate = 9999-12-31` marca a versao vigente.","content":{"application/json":{"schema":{"description":"Trajetoria cadastral do CNPJ. Cada versao vigora em `[valido_de, valido_ate)`.","properties":{"prismadata__pessoa_juridica__cnpj":{"title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__versoes":{"description":"Versoes em ordem cronologica ASC. `valido_ate = 9999-12-31` marca a versao vigente.","items":{"$ref":"#/components/schemas/VersaoCadastralPublica"},"title":"Prismadata  Pessoa Juridica  Versoes","type":"array"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__versoes"],"title":"HistoricoCadastralResponse","type":"object"},"example":{"prismadata__pessoa_juridica__cnpj":"33000167000101","prismadata__pessoa_juridica__cnpj_basico":"33000167","prismadata__pessoa_juridica__versoes":[{"prismadata__pessoa_juridica__valido_de":"2023-05-01","prismadata__pessoa_juridica__valido_ate":"2023-08-01","prismadata__pessoa_juridica__razao_social":"PETROLEO BRASILEIRO S A PETROBRAS","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__natureza_juridica_codigo":"2038","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__cnae_principal_codigo":"0600001","prismadata__pessoa_juridica__logradouro":"REPUBLICA DO CHILE","prismadata__pessoa_juridica__numero":"65","prismadata__pessoa_juridica__municipio_codigo":"0006001","prismadata__pessoa_juridica__uf":"RJ","prismadata__pessoa_juridica__cep":"20031-170"},{"prismadata__pessoa_juridica__valido_de":"2023-08-01","prismadata__pessoa_juridica__valido_ate":"9999-12-31","prismadata__pessoa_juridica__razao_social":"PETROLEO BRASILEIRO S A PETROBRAS","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__natureza_juridica_codigo":"2038","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__cnae_principal_codigo":"0600001","prismadata__pessoa_juridica__capital_social":"205431960490.52","prismadata__pessoa_juridica__logradouro":"REPUBLICA DO CHILE","prismadata__pessoa_juridica__numero":"65","prismadata__pessoa_juridica__municipio_codigo":"0006001","prismadata__pessoa_juridica__uf":"RJ","prismadata__pessoa_juridica__cep":"20031-170"}]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.prismadata.io/v1/cnpj/{cnpj}/historico\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\""},{"lang":"Python","source":"import httpx\n\nresp = httpx.get(\n    \"https://api.prismadata.io/v1/cnpj/{cnpj}/historico\",\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"}]}},"/cnpj/{cnpj}":{"get":{"tags":["CNPJ"],"summary":"Dados cadastrais de um CNPJ (formato plano)","description":"Lookup flat — sem socios nem cnaes_secundarios; agregacoes no lugar.\n\nCom `?data=YYYY-MM-DD`: point-in-time — retorna a versao do CNPJ\nvigente nessa data (periodo `[valido_de, valido_ate)`). Se `data`\nesta fora da janela historica disponivel, retorna 404 com detail\nespecifico (nao confunde com \"CNPJ nao encontrado\").","operationId":"consulta_cnpj_flat_cnpj__cnpj__get","parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"CNPJ com ou sem mascara (alfanumerico aceito)","title":"Cnpj"},"description":"CNPJ com ou sem mascara (alfanumerico aceito)"},{"name":"data","in":"query","required":false,"schema":{"anyOf":[{"type":"string","format":"date"},{"type":"null"}],"description":"Se informado, retorna o estado do CNPJ nessa data (YYYY-MM-DD). Sem ele, retorna o estado atual.","title":"Data"},"description":"Se informado, retorna o estado do CNPJ nessa data (YYYY-MM-DD). Sem ele, retorna o estado atual."}],"responses":{"200":{"description":"Dados do CNPJ na consulta padrao (com resumo de socios e CNAEs).","content":{"application/json":{"schema":{"description":"Dados de um CNPJ na consulta padrao (com resumo de socios e CNAEs).","properties":{"prismadata__pessoa_juridica__cnpj":{"description":"CNPJ de 14 caracteres, sem mascara.","title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"description":"Primeiros 8 caracteres do CNPJ (identifica a matriz e todas as filiais).","title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__cnpj_ordem":{"description":"4 caracteres que identificam a filial (0001 e a matriz).","title":"Prismadata  Pessoa Juridica  Cnpj Ordem","type":"string"},"prismadata__pessoa_juridica__cnpj_dv":{"description":"2 digitos verificadores.","title":"Prismadata  Pessoa Juridica  Cnpj Dv","type":"string"},"prismadata__pessoa_juridica__cnpj_alfanumerico":{"description":"`true` quando o CNPJ contem letras (formato novo da Receita Federal).","title":"Prismadata  Pessoa Juridica  Cnpj Alfanumerico","type":"boolean"},"prismadata__pessoa_juridica__matriz_filial":{"description":"`MATRIZ` ou `FILIAL`.","title":"Prismadata  Pessoa Juridica  Matriz Filial","type":"string"},"prismadata__pessoa_juridica__razao_social":{"description":"Razao social registrada na Receita Federal.","title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome fantasia declarado, se houver.","title":"Prismadata  Pessoa Juridica  Nome Fantasia"},"prismadata__pessoa_juridica__situacao_cadastral":{"description":"Situacao atual: `NULA`, `ATIVA`, `SUSPENSA`, `INAPTA` ou `BAIXADA`.","title":"Prismadata  Pessoa Juridica  Situacao Cadastral","type":"string"},"prismadata__pessoa_juridica__data_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) da ultima mudanca de situacao.","title":"Prismadata  Pessoa Juridica  Data Situacao Cadastral"},"prismadata__pessoa_juridica__motivo_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Motivo textual da situacao atual.","title":"Prismadata  Pessoa Juridica  Motivo Situacao Cadastral"},"prismadata__pessoa_juridica__data_abertura":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) de constituicao da empresa.","title":"Prismadata  Pessoa Juridica  Data Abertura"},"prismadata__pessoa_juridica__natureza_juridica_codigo":{"description":"Codigo IBGE da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Codigo","type":"string"},"prismadata__pessoa_juridica__natureza_juridica_descricao":{"description":"Descricao textual da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Descricao","type":"string"},"prismadata__pessoa_juridica__porte":{"description":"Porte: `NAO_INFORMADO`, `MICRO`, `PEQUENA` ou `DEMAIS`.","title":"Prismadata  Pessoa Juridica  Porte","type":"string"},"prismadata__pessoa_juridica__capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Capital social declarado (valor decimal em texto).","title":"Prismadata  Pessoa Juridica  Capital Social"},"prismadata__pessoa_juridica__opcao_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do Simples Nacional.","title":"Prismadata  Pessoa Juridica  Opcao Simples"},"prismadata__pessoa_juridica__data_opcao_simples":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao Simples.","title":"Prismadata  Pessoa Juridica  Data Opcao Simples"},"prismadata__pessoa_juridica__opcao_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do MEI.","title":"Prismadata  Pessoa Juridica  Opcao Mei"},"prismadata__pessoa_juridica__data_opcao_mei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao MEI.","title":"Prismadata  Pessoa Juridica  Data Opcao Mei"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"description":"Codigo CNAE da atividade principal (7 digitos).","title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo","type":"string"},"prismadata__pessoa_juridica__cnae_principal_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Descricao da atividade principal.","title":"Prismadata  Pessoa Juridica  Cnae Principal Descricao"},"prismadata__pessoa_juridica__cnae_secundario_1":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Primeiro CNAE secundario (na ordem em que aparece no cadastro).","title":"Prismadata  Pessoa Juridica  Cnae Secundario 1"},"prismadata__pessoa_juridica__cnae_secundario_2":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Segundo CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 2"},"prismadata__pessoa_juridica__cnae_secundario_3":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Terceiro CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 3"},"prismadata__pessoa_juridica__total_cnaes_secundarios":{"description":"Numero total de CNAEs secundarios registrados. Para ver a lista completa use a consulta detalhada.","title":"Prismadata  Pessoa Juridica  Total Cnaes Secundarios","type":"integer"},"prismadata__pessoa_juridica__logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do logradouro.","title":"Prismadata  Pessoa Juridica  Logradouro"},"prismadata__pessoa_juridica__numero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Numero do endereco.","title":"Prismadata  Pessoa Juridica  Numero"},"prismadata__pessoa_juridica__complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Complemento do endereco.","title":"Prismadata  Pessoa Juridica  Complemento"},"prismadata__pessoa_juridica__bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Bairro.","title":"Prismadata  Pessoa Juridica  Bairro"},"prismadata__pessoa_juridica__municipio_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo IBGE do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Codigo"},"prismadata__pessoa_juridica__municipio_nome":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Nome"},"prismadata__pessoa_juridica__uf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"UF (2 caracteres).","title":"Prismadata  Pessoa Juridica  Uf"},"prismadata__pessoa_juridica__cep":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CEP sem mascara.","title":"Prismadata  Pessoa Juridica  Cep"},"prismadata__pessoa_juridica__id_logradouro":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel do logradouro, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Logradouro"},"prismadata__pessoa_juridica__id_loc":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel da localizacao, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Loc"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Longitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__endereco_normalizado":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Endereco reescrito no padrao usado pela geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Normalizado"},"prismadata__pessoa_juridica__qualidade_geocodificacao_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Score de qualidade da geocodificacao (0-100).","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Score"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Classificacao da qualidade da geocodificacao: `MUITO_ALTA`, `ALTA`, `MEDIA`, `BAIXA`, `MUITO_BAIXA`, `CENTROIDE_MUNICIPIO` ou `NAO_GEOCODIFICADO`.","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"},"prismadata__pessoa_juridica__endereco_existe":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se o endereco foi encontrado na base de referencia da geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Existe"},"prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Sinaliza divergencia entre o endereco cadastrado na Receita Federal e o endereco geocodificado.","title":"Prismadata  Pessoa Juridica  Divergencia Endereco Rfb Geocoder"},"prismadata__pessoa_juridica__total_socios":{"description":"Numero total de socios cadastrados.","title":"Prismadata  Pessoa Juridica  Total Socios","type":"integer"},"prismadata__pessoa_juridica__total_socios_pf":{"description":"Numero de socios pessoa fisica.","title":"Prismadata  Pessoa Juridica  Total Socios Pf","type":"integer"},"prismadata__pessoa_juridica__total_socios_pj":{"description":"Numero de socios pessoa juridica.","title":"Prismadata  Pessoa Juridica  Total Socios Pj","type":"integer"},"prismadata__pessoa_juridica__total_socios_estrangeiro":{"description":"Numero de socios estrangeiros.","title":"Prismadata  Pessoa Juridica  Total Socios Estrangeiro","type":"integer"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data da publicacao dos dados pela Receita Federal.","title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data e hora em que os dados foram enriquecidos.","title":"Prismadata  Pessoa Juridica  Data Processamento"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__cnpj_ordem","prismadata__pessoa_juridica__cnpj_dv","prismadata__pessoa_juridica__cnpj_alfanumerico","prismadata__pessoa_juridica__matriz_filial","prismadata__pessoa_juridica__razao_social","prismadata__pessoa_juridica__situacao_cadastral","prismadata__pessoa_juridica__natureza_juridica_codigo","prismadata__pessoa_juridica__natureza_juridica_descricao","prismadata__pessoa_juridica__porte","prismadata__pessoa_juridica__cnae_principal_codigo","prismadata__pessoa_juridica__total_cnaes_secundarios","prismadata__pessoa_juridica__total_socios","prismadata__pessoa_juridica__total_socios_pf","prismadata__pessoa_juridica__total_socios_pj","prismadata__pessoa_juridica__total_socios_estrangeiro"],"title":"PessoaJuridicaFlatResponse","type":"object"},"example":{"prismadata__pessoa_juridica__bairro":"MERCES","prismadata__pessoa_juridica__capital_social":"500000.00","prismadata__pessoa_juridica__cep":"80810000","prismadata__pessoa_juridica__cnae_principal_codigo":"6141800","prismadata__pessoa_juridica__cnae_principal_descricao":"","prismadata__pessoa_juridica__cnae_secundario_1":"6110803","prismadata__pessoa_juridica__cnae_secundario_2":"6190699","prismadata__pessoa_juridica__cnae_secundario_3":"6190601","prismadata__pessoa_juridica__cnpj":"82554437000131","prismadata__pessoa_juridica__cnpj_alfanumerico":false,"prismadata__pessoa_juridica__cnpj_basico":"82554437","prismadata__pessoa_juridica__cnpj_dv":"31","prismadata__pessoa_juridica__cnpj_ordem":"0001","prismadata__pessoa_juridica__data_abertura":"1991-06-18","prismadata__pessoa_juridica__data_processamento":"2026-06-24T12:51:48Z","prismadata__pessoa_juridica__data_publicacao_rfb":"2026-03-01","prismadata__pessoa_juridica__data_situacao_cadastral":"2005-11-03","prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":false,"prismadata__pessoa_juridica__endereco_existe":true,"prismadata__pessoa_juridica__endereco_normalizado":"AVENIDA MANOEL RIBAS, 2447 - MERCES, CURITIBA - PR, 80810-002","prismadata__pessoa_juridica__id_loc":6604984264422369595,"prismadata__pessoa_juridica__id_logradouro":8339738480598698066,"prismadata__pessoa_juridica__latitude":"-25.415493","prismadata__pessoa_juridica__logradouro":"MANOEL RIBAS","prismadata__pessoa_juridica__longitude":"-49.298817","prismadata__pessoa_juridica__matriz_filial":"MATRIZ","prismadata__pessoa_juridica__motivo_situacao_cadastral":"SEM MOTIVO","prismadata__pessoa_juridica__municipio_codigo":"0007535","prismadata__pessoa_juridica__municipio_nome":"CURITIBA","prismadata__pessoa_juridica__natureza_juridica_codigo":"2062","prismadata__pessoa_juridica__natureza_juridica_descricao":"Sociedade Empresária Limitada","prismadata__pessoa_juridica__nome_fantasia":"BARIGUI TELECOM","prismadata__pessoa_juridica__numero":"2447","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":"ALTA","prismadata__pessoa_juridica__qualidade_geocodificacao_score":100,"prismadata__pessoa_juridica__razao_social":"TV BARIGUI LTDA","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__total_cnaes_secundarios":5,"prismadata__pessoa_juridica__total_socios":1,"prismadata__pessoa_juridica__total_socios_estrangeiro":0,"prismadata__pessoa_juridica__total_socios_pf":1,"prismadata__pessoa_juridica__total_socios_pj":0,"prismadata__pessoa_juridica__uf":"PR"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"422":{"description":"Parametros invalidos (CNPJ malformado, body incorreto, etc).","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.prismadata.io/v1/cnpj/{cnpj}\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\""},{"lang":"Python","source":"import httpx\n\nresp = httpx.get(\n    \"https://api.prismadata.io/v1/cnpj/{cnpj}\",\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nresult = client.cnpj(\"82.554.437/0001-31\")\nprint(result)"}]}},"/cnpj/endereco/cnpjs":{"post":{"operationId":"busca_cnpjs_por_endereco_cnpj_endereco_cnpjs_post","summary":"CNPJs localizados em um endereço","description":"**Reverse lookup por endereco.** Dado um endereco (logradouro + numero + municipio + UF, opcionalmente bairro, CEP e complemento), devolve a lista de CNPJs localizados no mesmo endereco.\n\nA granularidade e autodescoberta pelo campo `complemento`:\n- Com `complemento` informado: filtra pela mesma sala/andar (`granularidade=sala_andar`).\n- Sem `complemento`: devolve o predio inteiro (`granularidade=predio`).\n\n**Historico retrospectivo:** o campo `data_ref` permite consultar o estado do endereco em qualquer data desde maio/2023 (`\"2023-06-01\"`). Sem `data_ref`, devolve apenas quem esta no endereco atualmente.\n\n**Uso ideal:** due diligence de ponto comercial, enriquecimento de leads por endereco, analise de densidade de empresas, compliance KYC/KYB.\n\n**Enderecos com numero nao identificado** (`S/N`, `1000-A`) sao filtrados por default para evitar devolver centenas de CNPJs de uma rua inteira (`super_id_loc` interno).\n\n**Enderecos no exterior** (`uf=\"EX\"`) sao filtrados por construcao.\n\n**Cota:** uma consulta por chamada, independente do numero de CNPJs retornados.","tags":["CNPJ"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["logradouro","municipio","uf"],"properties":{"logradouro":{"type":"string","description":"Nome do logradouro, idealmente **com prefixo tipo** (`\"RUA ALAGOAS\"`, `\"AVENIDA PAULISTA\"`). A consulta tenta as duas variantes (com e sem split do tipo) e une os resultados."},"numero":{"type":"string","description":"Numero do imovel. Valores inconversiveis a inteiro (`S/N`, `1000-A`) sao tratados como numero ausente — a consulta devolve `cnpjs=[]` por filtro de endereco patologico."},"bairro":{"type":"string"},"municipio":{"type":"string","description":"Nome do municipio (acentos sao normalizados internamente)."},"uf":{"type":"string","minLength":2,"maxLength":2,"description":"Sigla da UF. `uf=\"EX\"` (exterior) devolve vazio."},"cep":{"type":"string"},"complemento":{"type":"string","description":"Quando informado, filtra pela mesma sala/andar via hash normalizado do complemento."},"data_ref":{"type":"string","format":"date","description":"Opcional. `YYYY-MM-DD`. Default: vigente (`9999-12-31`). Quando informado, retrocede ao estado do endereco naquela data."},"limit":{"type":"integer","minimum":1,"maximum":1000,"default":100},"offset":{"type":"integer","minimum":0,"default":0}},"example":{"logradouro":"RUA ALAGOAS","numero":"601","bairro":"SAVASSI","municipio":"BELO HORIZONTE","uf":"MG","cep":"30130165","complemento":"LOJA 26"}}}}},"responses":{"200":{"description":"Lista de CNPJs encontrados no endereco. Vazia quando o endereco nao e localizado ou quando todos os CNPJs foram filtrados.","content":{"application/json":{"schema":{"description":"Resposta do reverse lookup por endereco.","properties":{"prismadata__pessoa_juridica__id_loc":{"description":"Hash estavel do endereco (dialeto cadastral da RFB). CNPJs no mesmo `id_loc` estao fisicamente no mesmo ponto (predio).","title":"Prismadata  Pessoa Juridica  Id Loc","type":"integer"},"prismadata__pessoa_juridica__id_logradouro":{"description":"Hash estavel do logradouro (rua inteira).","title":"Prismadata  Pessoa Juridica  Id Logradouro","type":"integer"},"prismadata__pessoa_juridica__id_locs_tentados":{"description":"Lista de `id_loc` candidatos consultados pela API. A RFB grava o mesmo endereco em formatos variados (`'RUA ALAGOAS'` vs `'ALAGOAS'` com `tipo='RUA'` separado); a consulta tenta as duas variantes e une os resultados.","items":{"type":"integer"},"title":"Prismadata  Pessoa Juridica  Id Locs Tentados","type":"array"},"prismadata__pessoa_juridica__id_complemento":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Hash do complemento normalizado (sala/andar) quando o cliente informou o campo `complemento`. `null` quando a consulta foi so por predio.","title":"Prismadata  Pessoa Juridica  Id Complemento"},"prismadata__pessoa_juridica__granularidade":{"description":"`predio` (sem filtro por complemento) ou `sala_andar` (com complemento informado).","title":"Prismadata  Pessoa Juridica  Granularidade","type":"string"},"prismadata__pessoa_juridica__total":{"description":"Total exato de CNPJs encontrados ate 1000 (`\"3\"`, `\"47\"`, `\"999\"`). Acima disso retorna `\"1000+\"` como string. Pequena faixa `null` tambem possivel quando a consulta nao encontra nada.","title":"Prismadata  Pessoa Juridica  Total","type":"string"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latitude do endereco consultado. Todos os CNPJs retornados compartilham a mesma coordenada por construcao do `id_loc`. `null` quando a consulta nao encontra CNPJs no endereco.","title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Longitude do endereco consultado.","title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Qualidade da geocodificacao: `MUITO_ALTA`, `ALTA`, `MEDIA`, `BAIXA`, `MUITO_BAIXA`, `CENTROIDE_MUNICIPIO` ou `NAO_GEOCODIFICADO`. Util pra decidir se a coordenada e confiavel.","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"},"prismadata__pessoa_juridica__endereco_normalizado":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Endereco reescrito no padrao da base de referencia geocodificada (feedback 'foi isso que achamos'). Util pra validar se o endereco passado foi interpretado corretamente.","title":"Prismadata  Pessoa Juridica  Endereco Normalizado"},"prismadata__pessoa_juridica__motivo_vazio":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Preenchido somente quando `cnpjs` esta vazia. Explica por que a consulta nao devolveu nenhum CNPJ:\n- `super_id_loc`: o numero do endereco nao foi identificado (`S/N`, `1000-A`); a consulta refletiria a rua inteira e por isso e omitida.\n- `data_ref_sem_versao`: a `data_ref` consultada e anterior a maio/2023 (fora da janela historica disponivel).\n- `sem_cnpjs_cadastrados`: endereco e periodo validos; simplesmente nenhum CNPJ esta registrado nesse endereco.","title":"Prismadata  Pessoa Juridica  Motivo Vazio"},"prismadata__pessoa_juridica__cnpjs":{"description":"CNPJs encontrados no endereco (ordenados por `valido_de` DESC, depois `cnpj` ASC). Limite por `limit` da request. Vazio quando o endereco nao e encontrado na base.","items":{"$ref":"#/components/schemas/EnderecoCnpjItemPublico"},"title":"Prismadata  Pessoa Juridica  Cnpjs","type":"array"}},"required":["prismadata__pessoa_juridica__id_loc","prismadata__pessoa_juridica__id_logradouro","prismadata__pessoa_juridica__granularidade","prismadata__pessoa_juridica__total"],"title":"EnderecoCnpjsResponse","type":"object"},"example":{"prismadata__pessoa_juridica__id_loc":-601354731965171864,"prismadata__pessoa_juridica__id_logradouro":-7946691302918751496,"prismadata__pessoa_juridica__id_locs_tentados":[-601354731965171864,4406219503120246528],"prismadata__pessoa_juridica__id_complemento":-2964175950374335990,"prismadata__pessoa_juridica__granularidade":"sala_andar","prismadata__pessoa_juridica__total":"3","prismadata__pessoa_juridica__latitude":"-19.936710","prismadata__pessoa_juridica__longitude":"-43.937412","prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":"MUITO_ALTA","prismadata__pessoa_juridica__endereco_normalizado":"RUA ALAGOAS 601 SAVASSI BELO HORIZONTE MG 30130165","prismadata__pessoa_juridica__cnpjs":[{"prismadata__pessoa_juridica__cnpj":"58150174000110","prismadata__pessoa_juridica__razao_social":"PRISMADATA TECNOLOGIA LTDA","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__cnae_principal_codigo":"6311900","prismadata__pessoa_juridica__cnae_principal_descricao":"Tratamento de dados, provedores de servicos de aplicacao e servicos de hospedagem na internet","prismadata__pessoa_juridica__matriz_filial":"MATRIZ","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__id_complemento":-2964175950374335990,"prismadata__pessoa_juridica__valido_de":"2024-12-01","prismadata__pessoa_juridica__valido_ate":"9999-12-31"},{"prismadata__pessoa_juridica__cnpj":"59049480000128","prismadata__pessoa_juridica__razao_social":"G.T. ARQUITETURA LTDA.","prismadata__pessoa_juridica__situacao_cadastral":"ATIVA","prismadata__pessoa_juridica__cnae_principal_codigo":"7111100","prismadata__pessoa_juridica__cnae_principal_descricao":"Servicos de arquitetura","prismadata__pessoa_juridica__matriz_filial":"MATRIZ","prismadata__pessoa_juridica__porte":"DEMAIS","prismadata__pessoa_juridica__id_complemento":-2964175950374335990,"prismadata__pessoa_juridica__valido_de":"2025-02-01","prismadata__pessoa_juridica__valido_ate":"9999-12-31"}]}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Payload malformado — campos obrigatorios ausentes ou tipos invalidos.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"502":{"description":"Falha temporaria.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl -X POST \"https://api.prismadata.io/v1/cnpj/endereco/cnpjs\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }'"},{"lang":"Python","source":"import httpx\n\nresp = httpx.post(\n    \"https://api.prismadata.io/v1/cnpj/endereco/cnpjs\",\n    json={...},\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"}]}},"/cnpj/{cnpj}/enriched":{"get":{"operationId":"consulta_enriched_cnpj__cnpj__enriched_get","summary":"CNPJ enriquecido com dados territoriais do endereço","description":"Consulta um CNPJ e, na mesma chamada, agrega dados de servicos de localizacao da PrismaData (favelas, presidios, renda, etc.). Habilite os enriquecimentos desejados por parametro de query.\n\nSe o CNPJ nao tem coordenadas geocodificadas (por exemplo, quando o endereco cadastrado na Receita Federal nao pode ser geocodificado), os enriquecimentos solicitados nao sao executados — o resultado contem apenas os campos de `pessoa_juridica`.\n\n**Cota:** cada enriquecimento habilitado conta como uma consulta adicional. Enriquecimentos pulados por falta de coordenadas nao contam.","tags":["CNPJ"],"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string"},"description":"CNPJ de 14 caracteres, com ou sem mascara. Aceita CNPJ alfanumerico."},{"name":"slum","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Proximidade e classificacao de favelas."},{"name":"prison","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Proximidade e detalhes do presidio mais proximo."},{"name":"border","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Situacao em relacao a fronteiras internacionais."},{"name":"personal_income_static","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Renda media no ponto."},{"name":"personal_income_pdf","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Distribuicao de renda no ponto."},{"name":"commercial_cluster","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Aglomeracoes comerciais proximas."},{"name":"infosc","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Informacoes do setor censitario."},{"name":"tipologia","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Tipologia CNEFE."},{"name":"sandbox","in":"query","required":false,"schema":{"type":"boolean","default":false},"description":"Se `true`, retorna dados sinteticos para testes. Consultas em modo sandbox nao contam para efeito de cota."}],"responses":{"200":{"description":"Objeto JSON com os campos de `pessoa_juridica` (sempre presentes) e os campos de cada enriquecimento habilitado (quando o CNPJ tem coordenadas).","content":{"application/json":{"schema":{"additionalProperties":true,"description":"Dados do CNPJ com enriquecimentos geograficos habilitados.\n\nRetorna TODOS os campos da consulta padrao (`prismadata__pessoa_juridica__*`)\ne, quando o CNPJ tem coordenadas geocodificadas, cada enriquecimento\nhabilitado acrescenta um grupo de campos com prefixo proprio\n(por exemplo, `prismadata__slum__*`, `prismadata__border__*`).\n\nQuando o CNPJ nao tem coordenadas geocodificadas, so os campos de\n`pessoa_juridica` sao retornados.","properties":{"prismadata__pessoa_juridica__cnpj":{"description":"CNPJ de 14 caracteres, sem mascara.","title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"description":"Primeiros 8 caracteres do CNPJ (identifica a matriz e todas as filiais).","title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__cnpj_ordem":{"description":"4 caracteres que identificam a filial (0001 e a matriz).","title":"Prismadata  Pessoa Juridica  Cnpj Ordem","type":"string"},"prismadata__pessoa_juridica__cnpj_dv":{"description":"2 digitos verificadores.","title":"Prismadata  Pessoa Juridica  Cnpj Dv","type":"string"},"prismadata__pessoa_juridica__cnpj_alfanumerico":{"description":"`true` quando o CNPJ contem letras (formato novo da Receita Federal).","title":"Prismadata  Pessoa Juridica  Cnpj Alfanumerico","type":"boolean"},"prismadata__pessoa_juridica__matriz_filial":{"description":"`MATRIZ` ou `FILIAL`.","title":"Prismadata  Pessoa Juridica  Matriz Filial","type":"string"},"prismadata__pessoa_juridica__razao_social":{"description":"Razao social registrada na Receita Federal.","title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome fantasia declarado, se houver.","title":"Prismadata  Pessoa Juridica  Nome Fantasia"},"prismadata__pessoa_juridica__situacao_cadastral":{"description":"Situacao atual: `NULA`, `ATIVA`, `SUSPENSA`, `INAPTA` ou `BAIXADA`.","title":"Prismadata  Pessoa Juridica  Situacao Cadastral","type":"string"},"prismadata__pessoa_juridica__data_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) da ultima mudanca de situacao.","title":"Prismadata  Pessoa Juridica  Data Situacao Cadastral"},"prismadata__pessoa_juridica__motivo_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Motivo textual da situacao atual.","title":"Prismadata  Pessoa Juridica  Motivo Situacao Cadastral"},"prismadata__pessoa_juridica__data_abertura":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) de constituicao da empresa.","title":"Prismadata  Pessoa Juridica  Data Abertura"},"prismadata__pessoa_juridica__natureza_juridica_codigo":{"description":"Codigo IBGE da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Codigo","type":"string"},"prismadata__pessoa_juridica__natureza_juridica_descricao":{"description":"Descricao textual da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Descricao","type":"string"},"prismadata__pessoa_juridica__porte":{"description":"Porte: `NAO_INFORMADO`, `MICRO`, `PEQUENA` ou `DEMAIS`.","title":"Prismadata  Pessoa Juridica  Porte","type":"string"},"prismadata__pessoa_juridica__capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Capital social declarado (valor decimal em texto).","title":"Prismadata  Pessoa Juridica  Capital Social"},"prismadata__pessoa_juridica__opcao_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do Simples Nacional.","title":"Prismadata  Pessoa Juridica  Opcao Simples"},"prismadata__pessoa_juridica__data_opcao_simples":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao Simples.","title":"Prismadata  Pessoa Juridica  Data Opcao Simples"},"prismadata__pessoa_juridica__opcao_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do MEI.","title":"Prismadata  Pessoa Juridica  Opcao Mei"},"prismadata__pessoa_juridica__data_opcao_mei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao MEI.","title":"Prismadata  Pessoa Juridica  Data Opcao Mei"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"description":"Codigo CNAE da atividade principal (7 digitos).","title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo","type":"string"},"prismadata__pessoa_juridica__cnae_principal_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Descricao da atividade principal.","title":"Prismadata  Pessoa Juridica  Cnae Principal Descricao"},"prismadata__pessoa_juridica__cnae_secundario_1":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Primeiro CNAE secundario (na ordem em que aparece no cadastro).","title":"Prismadata  Pessoa Juridica  Cnae Secundario 1"},"prismadata__pessoa_juridica__cnae_secundario_2":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Segundo CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 2"},"prismadata__pessoa_juridica__cnae_secundario_3":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Terceiro CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 3"},"prismadata__pessoa_juridica__total_cnaes_secundarios":{"description":"Numero total de CNAEs secundarios registrados. Para ver a lista completa use a consulta detalhada.","title":"Prismadata  Pessoa Juridica  Total Cnaes Secundarios","type":"integer"},"prismadata__pessoa_juridica__logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do logradouro.","title":"Prismadata  Pessoa Juridica  Logradouro"},"prismadata__pessoa_juridica__numero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Numero do endereco.","title":"Prismadata  Pessoa Juridica  Numero"},"prismadata__pessoa_juridica__complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Complemento do endereco.","title":"Prismadata  Pessoa Juridica  Complemento"},"prismadata__pessoa_juridica__bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Bairro.","title":"Prismadata  Pessoa Juridica  Bairro"},"prismadata__pessoa_juridica__municipio_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo IBGE do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Codigo"},"prismadata__pessoa_juridica__municipio_nome":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Nome"},"prismadata__pessoa_juridica__uf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"UF (2 caracteres).","title":"Prismadata  Pessoa Juridica  Uf"},"prismadata__pessoa_juridica__cep":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CEP sem mascara.","title":"Prismadata  Pessoa Juridica  Cep"},"prismadata__pessoa_juridica__id_logradouro":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel do logradouro, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Logradouro"},"prismadata__pessoa_juridica__id_loc":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel da localizacao, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Loc"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Longitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__endereco_normalizado":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Endereco reescrito no padrao usado pela geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Normalizado"},"prismadata__pessoa_juridica__qualidade_geocodificacao_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Score de qualidade da geocodificacao (0-100).","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Score"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Classificacao da qualidade da geocodificacao: `MUITO_ALTA`, `ALTA`, `MEDIA`, `BAIXA`, `MUITO_BAIXA`, `CENTROIDE_MUNICIPIO` ou `NAO_GEOCODIFICADO`.","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"},"prismadata__pessoa_juridica__endereco_existe":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se o endereco foi encontrado na base de referencia da geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Existe"},"prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Sinaliza divergencia entre o endereco cadastrado na Receita Federal e o endereco geocodificado.","title":"Prismadata  Pessoa Juridica  Divergencia Endereco Rfb Geocoder"},"prismadata__pessoa_juridica__total_socios":{"description":"Numero total de socios cadastrados.","title":"Prismadata  Pessoa Juridica  Total Socios","type":"integer"},"prismadata__pessoa_juridica__total_socios_pf":{"description":"Numero de socios pessoa fisica.","title":"Prismadata  Pessoa Juridica  Total Socios Pf","type":"integer"},"prismadata__pessoa_juridica__total_socios_pj":{"description":"Numero de socios pessoa juridica.","title":"Prismadata  Pessoa Juridica  Total Socios Pj","type":"integer"},"prismadata__pessoa_juridica__total_socios_estrangeiro":{"description":"Numero de socios estrangeiros.","title":"Prismadata  Pessoa Juridica  Total Socios Estrangeiro","type":"integer"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data da publicacao dos dados pela Receita Federal.","title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data e hora em que os dados foram enriquecidos.","title":"Prismadata  Pessoa Juridica  Data Processamento"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__cnpj_ordem","prismadata__pessoa_juridica__cnpj_dv","prismadata__pessoa_juridica__cnpj_alfanumerico","prismadata__pessoa_juridica__matriz_filial","prismadata__pessoa_juridica__razao_social","prismadata__pessoa_juridica__situacao_cadastral","prismadata__pessoa_juridica__natureza_juridica_codigo","prismadata__pessoa_juridica__natureza_juridica_descricao","prismadata__pessoa_juridica__porte","prismadata__pessoa_juridica__cnae_principal_codigo","prismadata__pessoa_juridica__total_cnaes_secundarios","prismadata__pessoa_juridica__total_socios","prismadata__pessoa_juridica__total_socios_pf","prismadata__pessoa_juridica__total_socios_pj","prismadata__pessoa_juridica__total_socios_estrangeiro"],"title":"PessoaJuridicaEnrichedResponse","type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"CNPJ malformado.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"404":{"description":"CNPJ nao encontrado na versao atual dos dados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"502":{"description":"Falha temporaria em um dos servicos consultados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl \"https://api.prismadata.io/v1/cnpj/{cnpj}/enriched\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\""},{"lang":"Python","source":"import httpx\n\nresp = httpx.get(\n    \"https://api.prismadata.io/v1/cnpj/{cnpj}/enriched\",\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nresult = client.cnpj_enriched(\n    \"82554437000131\",\n    slum=True, border=True, tipologia=True,\n)\n# Quando o CNPJ nao tem lat/lng, as flags geo sao silenciosamente puladas\nif \"prismadata__slum__nome\" in result:\n    print(result[\"prismadata__slum__nome\"])"}]}},"/cnpj/batch/enriched":{"post":{"operationId":"consulta_enriched_lote_cnpj_batch_enriched_post","summary":"CNPJs enriquecidos em lote","description":"Consulta enriquecida em lote. Envie a lista de CNPJs e as flags de enriquecimento no body; receba um dicionario indexado pelo CNPJ.\n\nLimite: 256 CNPJs por chamada. CNPJs invalidos ou nao encontrados vem como `null` no dicionario.\n\n**Cota:** cada CNPJ conta como uma consulta base, mais uma consulta adicional por enriquecimento habilitado. Enriquecimentos pulados por falta de coordenadas nao contam.","tags":["CNPJ"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","required":["cnpjs"],"properties":{"cnpjs":{"type":"array","items":{"type":"string"},"maxItems":256,"description":"Lista de CNPJs a consultar."},"flags":{"type":"object","properties":{"slum":{"type":"boolean","default":false},"prison":{"type":"boolean","default":false},"border":{"type":"boolean","default":false},"personal_income_static":{"type":"boolean","default":false},"personal_income_pdf":{"type":"boolean","default":false},"commercial_cluster":{"type":"boolean","default":false},"infosc":{"type":"boolean","default":false},"tipologia":{"type":"boolean","default":false}},"description":"Enriquecimentos a habilitar para todos os CNPJs do lote."}}}}}},"responses":{"200":{"description":"Dicionario indexado pelo CNPJ. Valor `null` para CNPJs invalidos ou nao encontrados.","content":{"application/json":{"schema":{"additionalProperties":{"anyOf":[{"$ref":"#/components/schemas/PessoaJuridicaEnrichedResponse"},{"type":"null"}]},"description":"Resultado da consulta enriquecida em lote: dicionario indexado pelo CNPJ.","title":"EnrichedBatchResponse","type":"object"}}},"headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"400":{"description":"Lista de CNPJs vazia ou acima do limite.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"401":{"description":"Chave de API ausente ou invalida.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"403":{"description":"Sua chave de API nao tem permissao para este endpoint.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"502":{"description":"Falha temporaria em um dos servicos consultados.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}}},"429":{"$ref":"#/components/responses/RateLimitExceeded"}},"x-codeSamples":[{"lang":"curl","source":"curl -X POST \"https://api.prismadata.io/v1/cnpj/batch/enriched\" \\\n  -H \"X-Apikey: ak_xxxxxxxxxxxxxxxx\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{ ... }'"},{"lang":"Python","source":"import httpx\n\nresp = httpx.post(\n    \"https://api.prismadata.io/v1/cnpj/batch/enriched\",\n    json={...},\n    headers={\"X-Apikey\": \"ak_xxxxxxxxxxxxxxxx\"},\n)\ndados = resp.json()"},{"lang":"Python SDK","source":"from prismadata import Client\n\nclient = Client(api_key=\"ak_xxxxxxxxxxxxxxxx\")\nresult = client.cnpj_batch_enriched(\n    [\"82554437000131\", \"60701190076771\"],\n    slum=True, tipologia=True,\n)\nprint(result)"}]}}},"components":{"securitySchemes":{"X-Apikey":{"type":"apiKey","in":"header","name":"X-Apikey","description":"Token de acesso via header."},"api_key":{"type":"apiKey","in":"query","name":"api_key","description":"Token de acesso via query parameter."},"BearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT","description":"Token JWT obtido via POST /auth/token"}},"headers":{"X-RateLimit-Limit":{"description":"Número máximo de requisições permitidas por minuto para o usuário.","schema":{"type":"integer","example":60}},"X-RateLimit-Remaining":{"description":"Número de requisições restantes na janela de rate limit atual.","schema":{"type":"integer","example":57}},"X-RateLimit-Reset":{"description":"Unix timestamp (segundos) indicando quando a janela de rate limit será reiniciada.","schema":{"type":"integer","example":1738281600}}},"responses":{"RateLimitExceeded":{"description":"Too Many Requests - Rate limit ou quota excedidos.","headers":{"X-RateLimit-Limit":{"$ref":"#/components/headers/X-RateLimit-Limit"},"X-RateLimit-Remaining":{"$ref":"#/components/headers/X-RateLimit-Remaining"},"X-RateLimit-Reset":{"$ref":"#/components/headers/X-RateLimit-Reset"}},"content":{"text/plain":{"schema":{"type":"string"},"examples":{"rate_limit":{"summary":"Rate limit excedido","value":"rate limit exceeded"},"quota":{"summary":"Quota excedida","value":"limit exceeded: 1000 requests used, limit is 1000"}}}}}},"schemas":{"EnderecoCnpjItemPublico":{"description":"Um CNPJ localizado no endereco consultado (shape da lista `cnpjs`).","properties":{"prismadata__pessoa_juridica__cnpj":{"description":"CNPJ de 14 caracteres, sem mascara.","title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__razao_social":{"title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"`NULA`, `ATIVA`, `SUSPENSA`, `INAPTA` ou `BAIXADA`.","title":"Prismadata  Pessoa Juridica  Situacao Cadastral"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo CNAE 2.3 (7 digitos sem separador).","title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo"},"prismadata__pessoa_juridica__cnae_principal_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Descricao da atividade economica principal.","title":"Prismadata  Pessoa Juridica  Cnae Principal Descricao"},"prismadata__pessoa_juridica__matriz_filial":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"`MATRIZ` ou `FILIAL`.","title":"Prismadata  Pessoa Juridica  Matriz Filial"},"prismadata__pessoa_juridica__porte":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"`MICRO EMPRESA`, `EMPRESA DE PEQUENO PORTE` ou `DEMAIS`.","title":"Prismadata  Pessoa Juridica  Porte"},"prismadata__pessoa_juridica__id_complemento":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Hash estavel do complemento normalizado (sala/andar). CNPJs com o mesmo valor estao no mesmo complemento. `null` quando o CNPJ nao tem complemento preenchido.","title":"Prismadata  Pessoa Juridica  Id Complemento"},"prismadata__pessoa_juridica__valido_de":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) a partir da qual essa versao do CNPJ vigora no endereco.","title":"Prismadata  Pessoa Juridica  Valido De"},"prismadata__pessoa_juridica__valido_ate":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"`9999-12-31` indica versao vigente; data finita indica que o CNPJ saiu do endereco nessa data.","title":"Prismadata  Pessoa Juridica  Valido Ate"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__razao_social"],"title":"EnderecoCnpjItemPublico","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"type":"array","title":"Detail"}},"type":"object","title":"HTTPValidationError"},"LoteRequest":{"properties":{"cnpjs":{"items":{"type":"string"},"type":"array","minItems":1,"title":"Cnpjs"}},"type":"object","required":["cnpjs"],"title":"LoteRequest"},"PessoaJuridicaEnrichedResponse":{"additionalProperties":true,"description":"Dados do CNPJ com enriquecimentos geograficos habilitados.\n\nRetorna TODOS os campos da consulta padrao (`prismadata__pessoa_juridica__*`)\ne, quando o CNPJ tem coordenadas geocodificadas, cada enriquecimento\nhabilitado acrescenta um grupo de campos com prefixo proprio\n(por exemplo, `prismadata__slum__*`, `prismadata__border__*`).\n\nQuando o CNPJ nao tem coordenadas geocodificadas, so os campos de\n`pessoa_juridica` sao retornados.","properties":{"prismadata__pessoa_juridica__cnpj":{"description":"CNPJ de 14 caracteres, sem mascara.","title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"description":"Primeiros 8 caracteres do CNPJ (identifica a matriz e todas as filiais).","title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__cnpj_ordem":{"description":"4 caracteres que identificam a filial (0001 e a matriz).","title":"Prismadata  Pessoa Juridica  Cnpj Ordem","type":"string"},"prismadata__pessoa_juridica__cnpj_dv":{"description":"2 digitos verificadores.","title":"Prismadata  Pessoa Juridica  Cnpj Dv","type":"string"},"prismadata__pessoa_juridica__cnpj_alfanumerico":{"description":"`true` quando o CNPJ contem letras (formato novo da Receita Federal).","title":"Prismadata  Pessoa Juridica  Cnpj Alfanumerico","type":"boolean"},"prismadata__pessoa_juridica__matriz_filial":{"description":"`MATRIZ` ou `FILIAL`.","title":"Prismadata  Pessoa Juridica  Matriz Filial","type":"string"},"prismadata__pessoa_juridica__razao_social":{"description":"Razao social registrada na Receita Federal.","title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome fantasia declarado, se houver.","title":"Prismadata  Pessoa Juridica  Nome Fantasia"},"prismadata__pessoa_juridica__situacao_cadastral":{"description":"Situacao atual: `NULA`, `ATIVA`, `SUSPENSA`, `INAPTA` ou `BAIXADA`.","title":"Prismadata  Pessoa Juridica  Situacao Cadastral","type":"string"},"prismadata__pessoa_juridica__data_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) da ultima mudanca de situacao.","title":"Prismadata  Pessoa Juridica  Data Situacao Cadastral"},"prismadata__pessoa_juridica__motivo_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Motivo textual da situacao atual.","title":"Prismadata  Pessoa Juridica  Motivo Situacao Cadastral"},"prismadata__pessoa_juridica__data_abertura":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) de constituicao da empresa.","title":"Prismadata  Pessoa Juridica  Data Abertura"},"prismadata__pessoa_juridica__natureza_juridica_codigo":{"description":"Codigo IBGE da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Codigo","type":"string"},"prismadata__pessoa_juridica__natureza_juridica_descricao":{"description":"Descricao textual da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Descricao","type":"string"},"prismadata__pessoa_juridica__porte":{"description":"Porte: `NAO_INFORMADO`, `MICRO`, `PEQUENA` ou `DEMAIS`.","title":"Prismadata  Pessoa Juridica  Porte","type":"string"},"prismadata__pessoa_juridica__capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Capital social declarado (valor decimal em texto).","title":"Prismadata  Pessoa Juridica  Capital Social"},"prismadata__pessoa_juridica__opcao_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do Simples Nacional.","title":"Prismadata  Pessoa Juridica  Opcao Simples"},"prismadata__pessoa_juridica__data_opcao_simples":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao Simples.","title":"Prismadata  Pessoa Juridica  Data Opcao Simples"},"prismadata__pessoa_juridica__opcao_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do MEI.","title":"Prismadata  Pessoa Juridica  Opcao Mei"},"prismadata__pessoa_juridica__data_opcao_mei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao MEI.","title":"Prismadata  Pessoa Juridica  Data Opcao Mei"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"description":"Codigo CNAE da atividade principal (7 digitos).","title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo","type":"string"},"prismadata__pessoa_juridica__cnae_principal_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Descricao da atividade principal.","title":"Prismadata  Pessoa Juridica  Cnae Principal Descricao"},"prismadata__pessoa_juridica__cnae_secundario_1":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Primeiro CNAE secundario (na ordem em que aparece no cadastro).","title":"Prismadata  Pessoa Juridica  Cnae Secundario 1"},"prismadata__pessoa_juridica__cnae_secundario_2":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Segundo CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 2"},"prismadata__pessoa_juridica__cnae_secundario_3":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Terceiro CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 3"},"prismadata__pessoa_juridica__total_cnaes_secundarios":{"description":"Numero total de CNAEs secundarios registrados. Para ver a lista completa use a consulta detalhada.","title":"Prismadata  Pessoa Juridica  Total Cnaes Secundarios","type":"integer"},"prismadata__pessoa_juridica__logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do logradouro.","title":"Prismadata  Pessoa Juridica  Logradouro"},"prismadata__pessoa_juridica__numero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Numero do endereco.","title":"Prismadata  Pessoa Juridica  Numero"},"prismadata__pessoa_juridica__complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Complemento do endereco.","title":"Prismadata  Pessoa Juridica  Complemento"},"prismadata__pessoa_juridica__bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Bairro.","title":"Prismadata  Pessoa Juridica  Bairro"},"prismadata__pessoa_juridica__municipio_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo IBGE do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Codigo"},"prismadata__pessoa_juridica__municipio_nome":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Nome"},"prismadata__pessoa_juridica__uf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"UF (2 caracteres).","title":"Prismadata  Pessoa Juridica  Uf"},"prismadata__pessoa_juridica__cep":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CEP sem mascara.","title":"Prismadata  Pessoa Juridica  Cep"},"prismadata__pessoa_juridica__id_logradouro":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel do logradouro, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Logradouro"},"prismadata__pessoa_juridica__id_loc":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel da localizacao, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Loc"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Longitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__endereco_normalizado":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Endereco reescrito no padrao usado pela geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Normalizado"},"prismadata__pessoa_juridica__qualidade_geocodificacao_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Score de qualidade da geocodificacao (0-100).","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Score"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Classificacao da qualidade da geocodificacao: `MUITO_ALTA`, `ALTA`, `MEDIA`, `BAIXA`, `MUITO_BAIXA`, `CENTROIDE_MUNICIPIO` ou `NAO_GEOCODIFICADO`.","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"},"prismadata__pessoa_juridica__endereco_existe":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se o endereco foi encontrado na base de referencia da geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Existe"},"prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Sinaliza divergencia entre o endereco cadastrado na Receita Federal e o endereco geocodificado.","title":"Prismadata  Pessoa Juridica  Divergencia Endereco Rfb Geocoder"},"prismadata__pessoa_juridica__total_socios":{"description":"Numero total de socios cadastrados.","title":"Prismadata  Pessoa Juridica  Total Socios","type":"integer"},"prismadata__pessoa_juridica__total_socios_pf":{"description":"Numero de socios pessoa fisica.","title":"Prismadata  Pessoa Juridica  Total Socios Pf","type":"integer"},"prismadata__pessoa_juridica__total_socios_pj":{"description":"Numero de socios pessoa juridica.","title":"Prismadata  Pessoa Juridica  Total Socios Pj","type":"integer"},"prismadata__pessoa_juridica__total_socios_estrangeiro":{"description":"Numero de socios estrangeiros.","title":"Prismadata  Pessoa Juridica  Total Socios Estrangeiro","type":"integer"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data da publicacao dos dados pela Receita Federal.","title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data e hora em que os dados foram enriquecidos.","title":"Prismadata  Pessoa Juridica  Data Processamento"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__cnpj_ordem","prismadata__pessoa_juridica__cnpj_dv","prismadata__pessoa_juridica__cnpj_alfanumerico","prismadata__pessoa_juridica__matriz_filial","prismadata__pessoa_juridica__razao_social","prismadata__pessoa_juridica__situacao_cadastral","prismadata__pessoa_juridica__natureza_juridica_codigo","prismadata__pessoa_juridica__natureza_juridica_descricao","prismadata__pessoa_juridica__porte","prismadata__pessoa_juridica__cnae_principal_codigo","prismadata__pessoa_juridica__total_cnaes_secundarios","prismadata__pessoa_juridica__total_socios","prismadata__pessoa_juridica__total_socios_pf","prismadata__pessoa_juridica__total_socios_pj","prismadata__pessoa_juridica__total_socios_estrangeiro"],"title":"PessoaJuridicaEnrichedResponse","type":"object"},"PessoaJuridicaFlatResponse":{"description":"Dados de um CNPJ na consulta padrao (com resumo de socios e CNAEs).","properties":{"prismadata__pessoa_juridica__cnpj":{"description":"CNPJ de 14 caracteres, sem mascara.","title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"description":"Primeiros 8 caracteres do CNPJ (identifica a matriz e todas as filiais).","title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__cnpj_ordem":{"description":"4 caracteres que identificam a filial (0001 e a matriz).","title":"Prismadata  Pessoa Juridica  Cnpj Ordem","type":"string"},"prismadata__pessoa_juridica__cnpj_dv":{"description":"2 digitos verificadores.","title":"Prismadata  Pessoa Juridica  Cnpj Dv","type":"string"},"prismadata__pessoa_juridica__cnpj_alfanumerico":{"description":"`true` quando o CNPJ contem letras (formato novo da Receita Federal).","title":"Prismadata  Pessoa Juridica  Cnpj Alfanumerico","type":"boolean"},"prismadata__pessoa_juridica__matriz_filial":{"description":"`MATRIZ` ou `FILIAL`.","title":"Prismadata  Pessoa Juridica  Matriz Filial","type":"string"},"prismadata__pessoa_juridica__razao_social":{"description":"Razao social registrada na Receita Federal.","title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome fantasia declarado, se houver.","title":"Prismadata  Pessoa Juridica  Nome Fantasia"},"prismadata__pessoa_juridica__situacao_cadastral":{"description":"Situacao atual: `NULA`, `ATIVA`, `SUSPENSA`, `INAPTA` ou `BAIXADA`.","title":"Prismadata  Pessoa Juridica  Situacao Cadastral","type":"string"},"prismadata__pessoa_juridica__data_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) da ultima mudanca de situacao.","title":"Prismadata  Pessoa Juridica  Data Situacao Cadastral"},"prismadata__pessoa_juridica__motivo_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Motivo textual da situacao atual.","title":"Prismadata  Pessoa Juridica  Motivo Situacao Cadastral"},"prismadata__pessoa_juridica__data_abertura":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data (`YYYY-MM-DD`) de constituicao da empresa.","title":"Prismadata  Pessoa Juridica  Data Abertura"},"prismadata__pessoa_juridica__natureza_juridica_codigo":{"description":"Codigo IBGE da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Codigo","type":"string"},"prismadata__pessoa_juridica__natureza_juridica_descricao":{"description":"Descricao textual da natureza juridica.","title":"Prismadata  Pessoa Juridica  Natureza Juridica Descricao","type":"string"},"prismadata__pessoa_juridica__porte":{"description":"Porte: `NAO_INFORMADO`, `MICRO`, `PEQUENA` ou `DEMAIS`.","title":"Prismadata  Pessoa Juridica  Porte","type":"string"},"prismadata__pessoa_juridica__capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Capital social declarado (valor decimal em texto).","title":"Prismadata  Pessoa Juridica  Capital Social"},"prismadata__pessoa_juridica__opcao_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do Simples Nacional.","title":"Prismadata  Pessoa Juridica  Opcao Simples"},"prismadata__pessoa_juridica__data_opcao_simples":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao Simples.","title":"Prismadata  Pessoa Juridica  Data Opcao Simples"},"prismadata__pessoa_juridica__opcao_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se e optante do MEI.","title":"Prismadata  Pessoa Juridica  Opcao Mei"},"prismadata__pessoa_juridica__data_opcao_mei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data de adesao ao MEI.","title":"Prismadata  Pessoa Juridica  Data Opcao Mei"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"description":"Codigo CNAE da atividade principal (7 digitos).","title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo","type":"string"},"prismadata__pessoa_juridica__cnae_principal_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Descricao da atividade principal.","title":"Prismadata  Pessoa Juridica  Cnae Principal Descricao"},"prismadata__pessoa_juridica__cnae_secundario_1":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Primeiro CNAE secundario (na ordem em que aparece no cadastro).","title":"Prismadata  Pessoa Juridica  Cnae Secundario 1"},"prismadata__pessoa_juridica__cnae_secundario_2":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Segundo CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 2"},"prismadata__pessoa_juridica__cnae_secundario_3":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Terceiro CNAE secundario.","title":"Prismadata  Pessoa Juridica  Cnae Secundario 3"},"prismadata__pessoa_juridica__total_cnaes_secundarios":{"description":"Numero total de CNAEs secundarios registrados. Para ver a lista completa use a consulta detalhada.","title":"Prismadata  Pessoa Juridica  Total Cnaes Secundarios","type":"integer"},"prismadata__pessoa_juridica__logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do logradouro.","title":"Prismadata  Pessoa Juridica  Logradouro"},"prismadata__pessoa_juridica__numero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Numero do endereco.","title":"Prismadata  Pessoa Juridica  Numero"},"prismadata__pessoa_juridica__complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Complemento do endereco.","title":"Prismadata  Pessoa Juridica  Complemento"},"prismadata__pessoa_juridica__bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Bairro.","title":"Prismadata  Pessoa Juridica  Bairro"},"prismadata__pessoa_juridica__municipio_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo IBGE do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Codigo"},"prismadata__pessoa_juridica__municipio_nome":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do municipio.","title":"Prismadata  Pessoa Juridica  Municipio Nome"},"prismadata__pessoa_juridica__uf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"UF (2 caracteres).","title":"Prismadata  Pessoa Juridica  Uf"},"prismadata__pessoa_juridica__cep":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CEP sem mascara.","title":"Prismadata  Pessoa Juridica  Cep"},"prismadata__pessoa_juridica__id_logradouro":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel do logradouro, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Logradouro"},"prismadata__pessoa_juridica__id_loc":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Identificador estavel da localizacao, util para correlacionar com outros produtos de geolocalizacao da PrismaData.","title":"Prismadata  Pessoa Juridica  Id Loc"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Latitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Longitude do endereco. `null` quando nao foi possivel geocodificar.","title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__endereco_normalizado":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Endereco reescrito no padrao usado pela geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Normalizado"},"prismadata__pessoa_juridica__qualidade_geocodificacao_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Score de qualidade da geocodificacao (0-100).","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Score"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Classificacao da qualidade da geocodificacao: `MUITO_ALTA`, `ALTA`, `MEDIA`, `BAIXA`, `MUITO_BAIXA`, `CENTROIDE_MUNICIPIO` ou `NAO_GEOCODIFICADO`.","title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"},"prismadata__pessoa_juridica__endereco_existe":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Se o endereco foi encontrado na base de referencia da geocodificacao.","title":"Prismadata  Pessoa Juridica  Endereco Existe"},"prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"description":"Sinaliza divergencia entre o endereco cadastrado na Receita Federal e o endereco geocodificado.","title":"Prismadata  Pessoa Juridica  Divergencia Endereco Rfb Geocoder"},"prismadata__pessoa_juridica__total_socios":{"description":"Numero total de socios cadastrados.","title":"Prismadata  Pessoa Juridica  Total Socios","type":"integer"},"prismadata__pessoa_juridica__total_socios_pf":{"description":"Numero de socios pessoa fisica.","title":"Prismadata  Pessoa Juridica  Total Socios Pf","type":"integer"},"prismadata__pessoa_juridica__total_socios_pj":{"description":"Numero de socios pessoa juridica.","title":"Prismadata  Pessoa Juridica  Total Socios Pj","type":"integer"},"prismadata__pessoa_juridica__total_socios_estrangeiro":{"description":"Numero de socios estrangeiros.","title":"Prismadata  Pessoa Juridica  Total Socios Estrangeiro","type":"integer"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data da publicacao dos dados pela Receita Federal.","title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data e hora em que os dados foram enriquecidos.","title":"Prismadata  Pessoa Juridica  Data Processamento"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__cnpj_ordem","prismadata__pessoa_juridica__cnpj_dv","prismadata__pessoa_juridica__cnpj_alfanumerico","prismadata__pessoa_juridica__matriz_filial","prismadata__pessoa_juridica__razao_social","prismadata__pessoa_juridica__situacao_cadastral","prismadata__pessoa_juridica__natureza_juridica_codigo","prismadata__pessoa_juridica__natureza_juridica_descricao","prismadata__pessoa_juridica__porte","prismadata__pessoa_juridica__cnae_principal_codigo","prismadata__pessoa_juridica__total_cnaes_secundarios","prismadata__pessoa_juridica__total_socios","prismadata__pessoa_juridica__total_socios_pf","prismadata__pessoa_juridica__total_socios_pj","prismadata__pessoa_juridica__total_socios_estrangeiro"],"title":"PessoaJuridicaFlatResponse","type":"object"},"PessoaJuridicaRawResponse":{"description":"Dados de um CNPJ na consulta detalhada (com lista completa de socios e CNAEs).","properties":{"prismadata__pessoa_juridica__cnpj":{"description":"CNPJ de 14 caracteres, sem mascara.","title":"Prismadata  Pessoa Juridica  Cnpj","type":"string"},"prismadata__pessoa_juridica__cnpj_basico":{"title":"Prismadata  Pessoa Juridica  Cnpj Basico","type":"string"},"prismadata__pessoa_juridica__cnpj_ordem":{"title":"Prismadata  Pessoa Juridica  Cnpj Ordem","type":"string"},"prismadata__pessoa_juridica__cnpj_dv":{"title":"Prismadata  Pessoa Juridica  Cnpj Dv","type":"string"},"prismadata__pessoa_juridica__cnpj_alfanumerico":{"title":"Prismadata  Pessoa Juridica  Cnpj Alfanumerico","type":"boolean"},"prismadata__pessoa_juridica__matriz_filial":{"title":"Prismadata  Pessoa Juridica  Matriz Filial","type":"string"},"prismadata__pessoa_juridica__razao_social":{"title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Nome Fantasia"},"prismadata__pessoa_juridica__situacao_cadastral":{"title":"Prismadata  Pessoa Juridica  Situacao Cadastral","type":"string"},"prismadata__pessoa_juridica__data_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Situacao Cadastral"},"prismadata__pessoa_juridica__motivo_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Motivo Situacao Cadastral"},"prismadata__pessoa_juridica__data_abertura":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Abertura"},"prismadata__pessoa_juridica__natureza_juridica_codigo":{"title":"Prismadata  Pessoa Juridica  Natureza Juridica Codigo","type":"string"},"prismadata__pessoa_juridica__natureza_juridica_descricao":{"title":"Prismadata  Pessoa Juridica  Natureza Juridica Descricao","type":"string"},"prismadata__pessoa_juridica__porte":{"title":"Prismadata  Pessoa Juridica  Porte","type":"string"},"prismadata__pessoa_juridica__capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Capital Social"},"prismadata__pessoa_juridica__opcao_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Opcao Simples"},"prismadata__pessoa_juridica__data_opcao_simples":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Opcao Simples"},"prismadata__pessoa_juridica__opcao_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Opcao Mei"},"prismadata__pessoa_juridica__data_opcao_mei":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Opcao Mei"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo","type":"string"},"prismadata__pessoa_juridica__cnae_principal_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Cnae Principal Descricao"},"prismadata__pessoa_juridica__cnaes_secundarios":{"description":"Lista completa de codigos CNAE secundarios.","items":{"type":"string"},"title":"Prismadata  Pessoa Juridica  Cnaes Secundarios","type":"array"},"prismadata__pessoa_juridica__logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Logradouro"},"prismadata__pessoa_juridica__numero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Numero"},"prismadata__pessoa_juridica__complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Complemento"},"prismadata__pessoa_juridica__bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Bairro"},"prismadata__pessoa_juridica__municipio_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Municipio Codigo"},"prismadata__pessoa_juridica__municipio_nome":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Municipio Nome"},"prismadata__pessoa_juridica__uf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Uf"},"prismadata__pessoa_juridica__cep":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Cep"},"prismadata__pessoa_juridica__id_logradouro":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Id Logradouro"},"prismadata__pessoa_juridica__id_loc":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Id Loc"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__endereco_normalizado":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Endereco Normalizado"},"prismadata__pessoa_juridica__qualidade_geocodificacao_score":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Score"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"},"prismadata__pessoa_juridica__endereco_existe":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Endereco Existe"},"prismadata__pessoa_juridica__divergencia_endereco_rfb_geocoder":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Divergencia Endereco Rfb Geocoder"},"prismadata__pessoa_juridica__socios":{"description":"Lista completa de socios com todos os campos originais.","items":{"$ref":"#/components/schemas/SocioPublico"},"title":"Prismadata  Pessoa Juridica  Socios","type":"array"},"prismadata__pessoa_juridica__data_publicacao_rfb":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Publicacao Rfb"},"prismadata__pessoa_juridica__data_processamento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Processamento"}},"required":["prismadata__pessoa_juridica__cnpj","prismadata__pessoa_juridica__cnpj_basico","prismadata__pessoa_juridica__cnpj_ordem","prismadata__pessoa_juridica__cnpj_dv","prismadata__pessoa_juridica__cnpj_alfanumerico","prismadata__pessoa_juridica__matriz_filial","prismadata__pessoa_juridica__razao_social","prismadata__pessoa_juridica__situacao_cadastral","prismadata__pessoa_juridica__natureza_juridica_codigo","prismadata__pessoa_juridica__natureza_juridica_descricao","prismadata__pessoa_juridica__porte","prismadata__pessoa_juridica__cnae_principal_codigo","prismadata__pessoa_juridica__cnaes_secundarios","prismadata__pessoa_juridica__socios"],"title":"PessoaJuridicaRawResponse","type":"object"},"SocioPublico":{"description":"Dados de um socio (item da lista `socios` na consulta detalhada).","properties":{"prismadata__pessoa_juridica__identificador_socio":{"description":"Tipo do socio: `PF`, `PJ` ou `ESTRANGEIRO`.","title":"Prismadata  Pessoa Juridica  Identificador Socio","type":"string"},"prismadata__pessoa_juridica__nome_ou_razao_social":{"description":"Nome do socio pessoa fisica ou razao social do socio pessoa juridica.","title":"Prismadata  Pessoa Juridica  Nome Ou Razao Social","type":"string"},"prismadata__pessoa_juridica__cnpj_cpf_socio":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CPF mascarado (formato `***.XXX.XXX-**`) para socios PF; CNPJ completo para socios PJ.","title":"Prismadata  Pessoa Juridica  Cnpj Cpf Socio"},"prismadata__pessoa_juridica__qualificacao_codigo":{"description":"Codigo da qualificacao do socio na sociedade.","title":"Prismadata  Pessoa Juridica  Qualificacao Codigo","type":"string"},"prismadata__pessoa_juridica__qualificacao_descricao":{"description":"Descricao textual da qualificacao (ex.: `Socio-Administrador`).","title":"Prismadata  Pessoa Juridica  Qualificacao Descricao","type":"string"},"prismadata__pessoa_juridica__data_entrada":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data em que o socio entrou na sociedade.","title":"Prismadata  Pessoa Juridica  Data Entrada"},"prismadata__pessoa_juridica__pais_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Codigo do pais de origem (para socios estrangeiros).","title":"Prismadata  Pessoa Juridica  Pais Codigo"},"prismadata__pessoa_juridica__representante_legal_cpf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CPF mascarado do representante legal (para socios pessoa juridica).","title":"Prismadata  Pessoa Juridica  Representante Legal Cpf"},"prismadata__pessoa_juridica__representante_legal_nome":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Nome do representante legal.","title":"Prismadata  Pessoa Juridica  Representante Legal Nome"},"prismadata__pessoa_juridica__faixa_etaria":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Faixa etaria do socio.","title":"Prismadata  Pessoa Juridica  Faixa Etaria"}},"required":["prismadata__pessoa_juridica__identificador_socio","prismadata__pessoa_juridica__nome_ou_razao_social","prismadata__pessoa_juridica__qualificacao_codigo","prismadata__pessoa_juridica__qualificacao_descricao"],"title":"SocioPublico","type":"object"},"ValidationError":{"properties":{"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"type":"array","title":"Location"},"msg":{"type":"string","title":"Message"},"type":{"type":"string","title":"Error Type"}},"type":"object","required":["loc","msg","type"],"title":"ValidationError"},"VersaoCadastralPublica":{"description":"Uma versao historica do estado cadastral do CNPJ, vigente em `[valido_de, valido_ate)`.","properties":{"prismadata__pessoa_juridica__valido_de":{"description":"Inicio da vigencia (`YYYY-MM-DD`).","title":"Prismadata  Pessoa Juridica  Valido De","type":"string"},"prismadata__pessoa_juridica__valido_ate":{"description":"Fim da vigencia (`YYYY-MM-DD`). `9999-12-31` indica versao vigente.","title":"Prismadata  Pessoa Juridica  Valido Ate","type":"string"},"prismadata__pessoa_juridica__razao_social":{"title":"Prismadata  Pessoa Juridica  Razao Social","type":"string"},"prismadata__pessoa_juridica__nome_fantasia":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Nome Fantasia"},"prismadata__pessoa_juridica__situacao_cadastral":{"title":"Prismadata  Pessoa Juridica  Situacao Cadastral","type":"string"},"prismadata__pessoa_juridica__data_situacao_cadastral":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Situacao Cadastral"},"prismadata__pessoa_juridica__data_abertura":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Data Abertura"},"prismadata__pessoa_juridica__natureza_juridica_codigo":{"title":"Prismadata  Pessoa Juridica  Natureza Juridica Codigo","type":"string"},"prismadata__pessoa_juridica__porte":{"title":"Prismadata  Pessoa Juridica  Porte","type":"string"},"prismadata__pessoa_juridica__capital_social":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Capital Social"},"prismadata__pessoa_juridica__opcao_simples":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Opcao Simples"},"prismadata__pessoa_juridica__opcao_mei":{"anyOf":[{"type":"boolean"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Opcao Mei"},"prismadata__pessoa_juridica__cnae_principal_codigo":{"title":"Prismadata  Pessoa Juridica  Cnae Principal Codigo","type":"string"},"prismadata__pessoa_juridica__logradouro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Logradouro"},"prismadata__pessoa_juridica__numero":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Numero"},"prismadata__pessoa_juridica__complemento":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Complemento"},"prismadata__pessoa_juridica__bairro":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Bairro"},"prismadata__pessoa_juridica__municipio_codigo":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Municipio Codigo"},"prismadata__pessoa_juridica__uf":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Uf"},"prismadata__pessoa_juridica__cep":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Cep"},"prismadata__pessoa_juridica__latitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Latitude"},"prismadata__pessoa_juridica__longitude":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Longitude"},"prismadata__pessoa_juridica__id_loc":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Id Loc"},"prismadata__pessoa_juridica__qualidade_geocodificacao_classificacao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"title":"Prismadata  Pessoa Juridica  Qualidade Geocodificacao Classificacao"}},"required":["prismadata__pessoa_juridica__valido_de","prismadata__pessoa_juridica__valido_ate","prismadata__pessoa_juridica__razao_social","prismadata__pessoa_juridica__situacao_cadastral","prismadata__pessoa_juridica__natureza_juridica_codigo","prismadata__pessoa_juridica__porte","prismadata__pessoa_juridica__cnae_principal_codigo"],"title":"VersaoCadastralPublica","type":"object"},"VersaoSocioPublica":{"description":"Uma versao historica de um socio (QSA) — 1 row por (socio, periodo de validade `[valido_de, valido_ate)`).","properties":{"prismadata__pessoa_juridica__valido_de":{"description":"Inicio da vigencia (`YYYY-MM-DD`).","title":"Prismadata  Pessoa Juridica  Valido De","type":"string"},"prismadata__pessoa_juridica__valido_ate":{"description":"Fim da vigencia. `9999-12-31` = versao vigente.","title":"Prismadata  Pessoa Juridica  Valido Ate","type":"string"},"prismadata__pessoa_juridica__identificador_socio":{"description":"`PF`, `PJ` ou `ESTRANGEIRO`.","title":"Prismadata  Pessoa Juridica  Identificador Socio","type":"string"},"prismadata__pessoa_juridica__nome_ou_razao_social":{"title":"Prismadata  Pessoa Juridica  Nome Ou Razao Social","type":"string"},"prismadata__pessoa_juridica__cnpj_cpf_socio":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"CPF mascarado (`***.XXX.XXX-**`) para PF; CNPJ formatado para PJ; `null` para estrangeiro.","title":"Prismadata  Pessoa Juridica  Cnpj Cpf Socio"},"prismadata__pessoa_juridica__qualificacao_codigo":{"description":"Codigo da qualificacao do socio na sociedade (2 digitos, tabela RFB).","title":"Prismadata  Pessoa Juridica  Qualificacao Codigo","type":"string"},"prismadata__pessoa_juridica__qualificacao_descricao":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Descricao textual da qualificacao (ex.: `Socio-Administrador`) derivada do codigo via lookup canonico RFB. Codigo nao catalogado retorna o proprio codigo como fallback.","title":"Prismadata  Pessoa Juridica  Qualificacao Descricao"},"prismadata__pessoa_juridica__data_entrada":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data em que o socio entrou na sociedade (fonte RFB). Pode ser `null` — RFB nao registra pra socios PJ e alguns socios antigos. Ver `data_entrada_efetiva` pra valor com fallback.","title":"Prismadata  Pessoa Juridica  Data Entrada"},"prismadata__pessoa_juridica__data_entrada_efetiva":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"Data efetiva: `data_entrada` original quando disponivel; caso contrario, competencia mais antiga em que o socio aparece nesse CNPJ (fallback). Sempre preenchida quando ha pelo menos 1 versao.","title":"Prismadata  Pessoa Juridica  Data Entrada Efetiva"},"prismadata__pessoa_juridica__data_entrada_estimada":{"default":false,"description":"`true` quando `data_entrada_efetiva` veio do fallback (`min(valido_de)`), `false` quando veio direto da RFB. Sinaliza precisao — estimada = data minima observada, nao necessariamente a data real de entrada.","title":"Prismadata  Pessoa Juridica  Data Entrada Estimada","type":"boolean"}},"required":["prismadata__pessoa_juridica__valido_de","prismadata__pessoa_juridica__valido_ate","prismadata__pessoa_juridica__identificador_socio","prismadata__pessoa_juridica__nome_ou_razao_social","prismadata__pessoa_juridica__qualificacao_codigo"],"title":"VersaoSocioPublica","type":"object"}}}}