API REST do Prospia

Base da API: https://api.prospia.ai. Autenticação por token pessoal (Bearer) com escopos por ferramenta, os mesmos do MCP.

GET /v1/health: Status da base (ok | empty-base). Sem autenticação.
GET /v1/cnaes: Catálogo oficial de CNAEs (código + descrição). Escopo: platform:leads_cnaes.
GET /v1/companies: Busca empresas ATIVAS por CNAE(s), UF e município (paginado). Medido por empresa retornada. Escopo: platform:leads_search.
GET /v1/cnpj/:cnpj: Consulta um CNPJ na base inteira (qualquer situação). Medido na cota mensal de consultas. 404 se não achar. Escopo: platform:cnpj_lookup.
POST /v1/companies/batch: Dados-base de uma lista de CNPJs (até 1000). Escopo: platform:leads_byCnpjs.
POST /v1/lead-requests: Cria um pedido de leads (CNAEs ∩ área), estima e enfileira o enriquecimento assíncrono. Escopo: platform:leads_request_create.
GET /v1/lead-requests/:id: Status + progresso do enriquecimento de um pedido. Escopo: platform:leads_request_status.
GET /v1/lead-requests/:id/results: Resultados paginados: leads contactáveis (canal + evidência + score/tier). Escopo: platform:leads_request_results.
POST /v1/lead-requests/:id/confirm: Inicia o enriquecimento de um pedido em awaiting-confirmation. Escopo: platform:leads_request_confirm.
POST /v1/lead-requests/:id/cancel: Cancela um pedido de leads. Escopo: platform:leads_request_cancel.
GET /v1/mcp/catalog: Catálogo MCP legível por máquina (conectores, URLs e escopos por ferramenta). Sem autenticação; não lista ferramentas admin.