{ "openapi": "3.1.0", "info": { "title": "AGENTUM Business", "version": "0.1.0", "description": "Agente comercial da AGENTUM: inteligência empresarial e verificação de contraparte, pagas por chamada via x402 (USDC, Base mainnet). Rotas HTTP diretas — o serviço também fala A2A (POST /) para agentes que preferem esse protocolo, ver /.well-known/agent-card.json.", "x-guidance": "Use GET /preflight?q= pra verificação de contraparte de uma empresa (brasileira ou não) antes de fechar negócio — devolve um veredito consolidado (band/confidence/flags), nunca um score inventado. Use GET /company-intelligence?cnpj=<14 dígitos> pra inteligência de CNPJ brasileiro cruzada com bases de integridade pública (TCU, CEIS, CNEP, CVM). Use GET /company?cnpj=<14 dígitos> pra cadastro básico (razão social, situação, endereço) sem a checagem de integridade. Todas exigem pagamento x402 em USDC na rede Base (eip155:8453), carteira 0x7D1EDdfBd167787251fed83b250ABBeA1cf59a6F.", "contact": { "email": "agentumcomercial@carmozinog.com" } }, "servers": [{ "url": "https://business.agentum.lat" }], "paths": { "/preflight": { "get": { "operationId": "preflight", "summary": "Verificação de contraparte (CNPJ, LEI ou nome de empresa)", "description": "Roteador que aceita um CNPJ brasileiro (14 dígitos), um código LEI (20 caracteres) ou um nome de empresa, e devolve um veredito consolidado de contraparte: entidade identificada, banda de risco (clear/flagged/insufficient_data), confiança na cobertura de dado, e os achados componentes com fonte e status individual. Nunca fabrica um score — band/flags são derivados deterministicamente de fatos verificados em fontes públicas oficiais.", "tags": ["Counterparty Verification"], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.150000" }, "protocols": [{ "x402": {} }] }, "parameters": [ { "name": "q", "in": "query", "required": true, "schema": { "type": "string", "description": "CNPJ brasileiro (14 dígitos, com ou sem máscara), código LEI (20 caracteres) ou nome de empresa" }, "example": "68964713000109" } ], "responses": { "200": { "description": "Veredito consolidado de contraparte", "content": { "application/json": { "schema": { "type": "object", "properties": { "query": { "type": "object", "properties": { "type": { "type": "string", "enum": ["cnpj", "lei", "name"] }, "value": { "type": "string" } } }, "entity": { "type": "object", "properties": { "name": { "type": "string" }, "jurisdiction": { "type": "string" }, "identifier": { "type": "object", "properties": { "type": { "type": "string" }, "value": { "type": "string" } } }, "status": { "type": "string" } } }, "band": { "type": "string", "enum": ["clear", "flagged", "insufficient_data"] }, "confidence": { "type": "string", "enum": ["high", "medium", "low"] }, "flags": { "type": "array", "items": { "type": "object", "properties": { "code": { "type": "string" }, "source": { "type": "string" }, "fact": { "type": "string" } } } }, "components": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "status": { "type": "string", "enum": ["verified", "not_found_in_checked_sources", "unavailable", "not_applicable", "conflicting"] }, "fact": { "type": "string" }, "observedAt": { "type": "string" } } } }, "sources": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "reference": { "type": ["string", "null"] } } } }, "coverage": { "type": "object" }, "as_of": { "type": "string" }, "version": { "type": "string" }, "disclaimer": { "type": "string" } } }, "example": { "query": { "type": "cnpj", "value": "68964713000109" }, "entity": { "name": "AGENTUM LTDA", "jurisdiction": "BR", "identifier": { "type": "cnpj", "value": "68964713000109" }, "status": "ATIVA" }, "band": "clear", "confidence": "high", "flags": [], "components": [ { "source": "TCU - Inidôneos e Suspensos", "status": "not_found_in_checked_sources", "fact": "Nenhum registro encontrado", "observedAt": "2026-09-11T12:00:00.000Z" } ], "sources": [{ "name": "TCU - Inidôneos e Suspensos", "reference": null }], "coverage": { "sourcesApplicable": ["TCU"], "sourcesCheckedSuccessfully": ["TCU"], "sourcesUnavailable": [] }, "as_of": "2026-09-11T12:00:00.000Z", "version": "1.0", "disclaimer": "Informação factual agregada de fontes públicas oficiais. Não é pontuação de risco, aconselhamento jurídico/financeiro, nem garantia de idoneidade — decisão final é de quem consulta." } } } }, "400": { "description": "Query inválida (não é CNPJ, LEI nem nome utilizável)" }, "404": { "description": "Nenhuma empresa encontrada pra esse LEI/nome" }, "402": { "description": "Payment Required" } } } }, "/company-intelligence": { "get": { "operationId": "companyIntelligence", "summary": "Inteligência de CNPJ brasileiro com checagem de integridade pública", "description": "Cadastro, situação e endereço de uma empresa brasileira, cruzados com bases oficiais de integridade (TCU Inidôneos, CEIS, CNEP) e dataset da CVM quando aplicável. Cada achado vem com fonte, status e horário da consulta — nenhum score agregado é inventado.", "tags": ["Company Intelligence"], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [{ "x402": {} }] }, "parameters": [ { "name": "cnpj", "in": "query", "required": true, "schema": { "type": "string", "description": "CNPJ brasileiro, 14 dígitos, com ou sem máscara" }, "example": "68964713000109" } ], "responses": { "200": { "description": "Cadastro consolidado + achados de integridade pública", "content": { "application/json": { "schema": { "type": "object", "properties": { "cnpj": { "type": "string" }, "company": { "type": "object" }, "findings": { "type": "array", "items": { "type": "object", "properties": { "source": { "type": "string" }, "sourceType": { "type": "string", "enum": ["official_api", "official_dataset"] }, "status": { "type": "string" }, "fact": { "type": "string" }, "observedAt": { "type": "string" } } } }, "coverage": { "type": "object" }, "derivedFindings": { "type": "array", "items": { "type": "object" } }, "performance": { "type": "object" }, "generatedAt": { "type": "string" } } }, "example": { "cnpj": "68964713000109", "company": { "razaoSocial": "AGENTUM LTDA", "situacaoCadastral": "ATIVA" }, "findings": [ { "source": "TCU - Inidôneos e Suspensos", "sourceType": "official_api", "status": "not_found_in_checked_sources", "fact": "Nenhum registro encontrado", "observedAt": "2026-09-11T12:00:00.000Z" } ], "coverage": { "sourcesApplicable": ["TCU", "CEIS", "CNEP"], "sourcesCheckedSuccessfully": ["TCU", "CEIS", "CNEP"], "sourcesUnavailable": [] }, "derivedFindings": [], "performance": { "totalMs": 850 }, "generatedAt": "2026-09-11T12:00:00.000Z" } } } }, "400": { "description": "CNPJ inválido" }, "502": { "description": "Fontes indisponíveis no momento da consulta" }, "402": { "description": "Payment Required" } } } }, "/company": { "get": { "operationId": "company", "summary": "Cadastro básico de CNPJ brasileiro", "description": "Razão social, situação cadastral, natureza jurídica, CNAE principal, endereço e indicação de Simples Nacional — agregado de fontes públicas (brasilapi.com.br, fallback receitaws.com.br). Sem checagem de integridade pública (ver /company-intelligence ou /preflight para isso).", "tags": ["Company Intelligence"], "x-payment-info": { "price": { "mode": "fixed", "currency": "USD", "amount": "0.020000" }, "protocols": [{ "x402": {} }] }, "parameters": [ { "name": "cnpj", "in": "query", "required": true, "schema": { "type": "string", "description": "CNPJ brasileiro, 14 dígitos, com ou sem máscara" }, "example": "68964713000109" } ], "responses": { "200": { "description": "Cadastro básico da empresa", "content": { "application/json": { "schema": { "type": "object", "properties": { "razaoSocial": { "type": "string" }, "nomeFantasia": { "type": ["string", "null"] }, "situacaoCadastral": { "type": "string" }, "naturezaJuridica": { "type": "string" }, "dataAbertura": { "type": "string" }, "cnaePrincipal": { "type": "string" }, "capitalSocial": { "type": ["number", "null"] }, "porte": { "type": "string" }, "simplesNacional": { "type": ["boolean", "null"] }, "endereco": { "type": "object", "properties": { "logradouro": { "type": ["string", "null"] }, "numero": { "type": ["string", "null"] }, "bairro": { "type": ["string", "null"] }, "municipio": { "type": ["string", "null"] }, "uf": { "type": ["string", "null"] }, "cep": { "type": ["string", "null"] } } }, "fonte": { "type": "string" } } }, "example": { "razaoSocial": "AGENTUM LTDA", "nomeFantasia": "AGENTUM", "situacaoCadastral": "ATIVA", "naturezaJuridica": "206-2 - Sociedade Empresária Limitada", "dataAbertura": "03/09/2026", "cnaePrincipal": "Desenvolvimento e licenciamento de programas de computador customizáveis", "capitalSocial": 10000, "porte": "MICRO EMPRESA", "simplesNacional": null, "endereco": { "logradouro": "R TEREZINHA DUQUE BORBOREMA", "numero": "289", "bairro": "CONJUNTO HABITACIONAL AUREA MENDES GIMENES", "municipio": "SERTAOZINHO", "uf": "SP", "cep": "14.178-210" }, "fonte": "brasilapi" } } } }, "400": { "description": "CNPJ inválido" }, "502": { "description": "Fontes indisponíveis no momento da consulta" }, "402": { "description": "Payment Required" } } } } } }