Os preços desta página são de tabela, sem assinatura — plano reduz o valor por consulta, e fonte de repasse cobra o emolumento da UF do alvo. O número que vale é o do POST /v1/orcamento/areas-contaminadas-sp, calculado sobre o alvo real e sem cobrar.
Companhia Ambiental do Estado de São Paulo (CETESB)
Áreas contaminadas — São Paulo
Procura o consultado no cadastro estadual de áreas contaminadas e reabilitadas de São Paulo, por nome.
Site oficial da fonte ↗/v1/consultas/areas-contaminadas-sp
v1
Tempo típico
não medido
A partir de
R$ 1,00
por consulta, varia por UF
Visão geral
Responde "o nome desta pessoa ou empresa aparece no cadastro de áreas contaminadas de São Paulo?" — o passivo ambiental que nenhuma certidão negativa mostra e que muda o preço de um imóvel, de uma aquisição ou de uma garantia.
A resposta traz a classificação de cada área (em investigação, contaminada, em reabilitação, reabilitada), que é o que separa um problema aberto de um encerrado.
Atenção: A busca é por NOME porque a base não tem documento nenhum. O resultado é candidato por semelhança — quem confirma o vínculo é você, comparando endereço e razão social.
Antes de começar
2 crítico · 1 de contexto
Cada item aqui saiu de um caso real que custou dinheiro. Ler isto é mais barato do que descobrir depois.
A base não tem CNPJ. Isso é do contrato, não uma limitação nossa
O cadastro publicado pelo estado identifica a área e o responsável por NOME. Não há CPF nem CNPJ em campo nenhum — então não existe consulta por documento, e não existe certeza de que o "EMPRESA EXEMPLO LTDA" da base é o seu.
Trate cada retorno como candidato a conferir: compare endereço, município e razão social antes de afirmar qualquer coisa. Homônimo de razão social é comum, e um passivo ambiental atribuído a quem não é dono dele é uma acusação.
Nome muito curto é recusado sem cobrar — buscar por três letras devolveria meia base.
Ausência aqui não é certidão de área limpa
NAO_ENCONTRADO significa que o nome pesquisado não casou com nenhum registro do cadastro estadual. Não significa que o imóvel é limpo: a área pode estar cadastrada em nome do proprietário anterior, do operador, ou não ter sido investigada ainda.
Para o imóvel, a pergunta certa é por endereço — e essa a base responde mal.
Só São Paulo
O cadastro é estadual. Passivo ambiental em outra UF não aparece aqui, e não há base nacional equivalente publicada em formato aberto.
Requisição
Autenticação por token no cabeçalho. Parâmetro obrigatório que falta é recusado antes de qualquer cobrança — não vira consulta paga que volta vazia.
cpf_cnpj
string
obrigatório
Identifica o alvo do pedido (é a quem o resultado fica associado e quem é cobrado). O documento NÃO é usado na busca — a base de origem não tem esse campo.
nome
string
obrigatório
Atenção: O termo efetivamente pesquisado: razão social ou nome do consultado. Sem ele a consulta é recusada sem cobrar, porque não há por onde buscar.
curl -X POST https://api.oficialdata.com.br/v1/consultas/areas-contaminadas-sp \
-H "Authorization: Bearer SEU_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"cpf_cnpj": "12345678000190",
"nome": "EMPRESA EXEMPLO LTDA"
}'
O HTTP é sempre 200 quando a requisição chegou.
O resultado real está em code, no corpo — trate
code, nunca o status.
Resposta
Dentro de data[]:
9 campos em 1 blocos.
Campo que a origem não informou volta null —
nunca 0 nem string vazia. Um zero inventado
vira "nada consta" num laudo.
data[]
object
SUCESSO, NAO_ENCONTRADO ou INDISPONIVEL. Nome sem ocorrência é resposta, não falha.
O termo que foi pesquisado, do jeito que foi para a origem. Confira: é o que explica o que voltou.
Quantas áreas casaram com o nome.
Quantos registros a origem devolveu, antes do agrupamento por área.
Contagem por classificação (em investigação, contaminada, em reabilitação, reabilitada). É o resumo que decide se há problema ABERTO.
Uma entrada por área, com endereço, município, classificação e a atividade que gerou o passivo.
Áreas encontradas mas não detalhadas por teto de leitura. Maior que zero significa que a lista detalhada não é exaustiva.
Frase pronta para tela e laudo.
Quando consultamos a origem, em ISO-8601.
Códigos de erro
O mesmo mapa que o motor usa em produção. As colunas de estorno e retentativa fazem parte do contrato: nem toda falha devolve o dinheiro, e você tem direito de saber quais antes de integrar.
| Classe | Códigos | Significa | Estorna | Retenta |
|---|---|---|---|---|
sucesso |
200 | A origem respondeu e entregou. | — | — |
nao_encontrado |
612 | A origem respondeu: nada consta para este alvo. | Não | Não |
indeterminado |
611 | A origem não conseguiu emitir pela internet. Não é irregularidade. | Não | Não |
erro_participante |
608 619 620 | A origem recusou os DADOS do pedido. | Não | Sim |
retry |
600 605 609 610 613 614 615 618 | Instabilidade momentânea da origem ou do transporte. | Sim | Sim |
fatal |
601 602 603 604 606 607 617 621 622 | Defeito de integração — nosso, não seu. | Sim | Não |
A pegadinha do estorno:
erro_participante é a única
classe que não devolve o dinheiro — nela a
origem respondeu, recusando os dados do pedido. Falha nossa é
fatal e sempre estorna.
Permanentes: 602 e 603 não se curam sozinhos — não vale retentar. A fonte sai do ar na hora e um humano é avisado.
Preço por UF
É emolumento de cartório, fixado por lei estadual. Orçar antes de disparar em lote não é boa prática, é requisito.
Mais barata
R$ 1,00
SP
Mediana
R$ 1,00
1 UFs vendáveis
Mais cara
R$ 1,00
SP — 1,0× a mais barata
Estes são os preços da sua conta. O valor é o emolumento do cartório mais a nossa margem, e a margem varia conforme o seu plano — planos maiores pagam menos por consulta.
SP
1,00
Limites e desempenho
Números medidos em produção. Onde está "não medido", é porque não medimos — e um número chutado aqui viraria SLA que ninguém verificou.
Tempo típico
não medido
p95
não medido
Teto por hora
—
Timeout máximo
—
De onde vem o tempo: dos ~s típicos, cerca de 85% é a origem varrendo os cartórios. Essa parte é intocável — não há otimização nossa que a reduza.
Sobre o teto: a origem exige sessão única por conta, então as corridas são serializadas. O número acima é o limite real de uma conta, não uma cota comercial. Volume acima disso exige combinar antes — não adianta paralelizar do seu lado.
Versionamento
O contrato de resposta é v1,
e a versão viaja em header.api_version
em toda resposta.
- Campo novo opcional pode entrar a qualquer momento e não muda a versão. Seu parser precisa ignorar campo que não conhece.
- Remover campo, renomear campo ou mudar tipo é versão nova, publicada em paralelo, com prazo de desligamento anunciado da anterior.
- Nunca alteramos o significado de um campo existente mantendo o nome. Se o significado muda, o nome muda junto.
Quer ser dos primeiros a integrar?
A ordem de liberação segue a demanda real. Diga o volume que você espera e em quais UFs.