{"openapi":"3.1.0","info":{"title":"brdata — Brazilian company & public-procurement data (x402)","version":"1.1.0","description":"Brazilian company & public-procurement data for due-diligence, KYB & B2B agents: company profiles by CNPJ (incl. full quadro societário / QSA), regulatory risk & compliance screening across 5 federal registries (debarment CEIS, anti-corruption CNEP, impeded non-profits CEPIM, leniency, and the forced-labor 'Lista Suja'), mass search & segmentation across ~28M active companies, and public tenders / licitações (PNCP). Each response carries per-source data_as_of freshness. All verdicts are informational indicators from public sources — not legal advice, a compliance certification, or a guarantee.","x-guidance":"Use this API for Brazilian company intelligence and public procurement. UNIQUE vs other Brazilian x402 APIs (which only do single-CNPJ lookup or check-digit validation): (1) POST /companies/search — segment ~28M active companies by CNAE activity (main or secondary), state/city, size, MEI, share capital, name; cursor-paginated; ideal for B2B lead lists & market research. (2) GET /risk/company/{cnpj} — regulatory risk & compliance screen across 5 federal registries: debarment (CEIS), anti-corruption (CNEP), impeded non-profits (CEPIM), leniency and the forced-labor register ('Lista Suja' — MTE) → verdict + 0–100 risk score, each hit flagged active vs historical, with per-source data_as_of. This is the Brazilian layer global OFAC/EU/UK/UN + PEP screens structurally miss (a company barred or listed for slave-like labor by the Brazilian government comes back clean on those) — PAIR brdata with an international sanctions/PEP provider for complete KYB. (3) Public tenders/licitações via PNCP — GET /tender/decode/{id}, POST /tender/resolve, GET /tender/{cnpj}/{year}/{seq}[/items|/documents], POST /tender/search; for bid/no-bid and B2G sales. If you already have a CNPJ, use GET /company/{cnpj} (basic) or /full (due diligence with partners + sanctions). GET /validate/{cnpj} is FREE. Prices are per call (per page for search); a call is charged only on success and invalid input is rejected for free. Data is public-registry only — no CPF is exposed and MEI contact fields are always redacted (LGPD).","contact":{"email":"contato@thomenz.me"}},"servers":[{"url":"https://brdata.thomenz.me"}],"paths":{"/company/{cnpj}":{"get":{"operationId":"lookupCompany","summary":"Company registry profile by CNPJ (basic)","description":"Consolidated official registry profile of any Brazilian company by CNPJ (tax ID): legal name, status, activities (CNAE), address, incorporation date. Aggregated from Brazilian Federal Revenue public data in a single call.","tags":["Companies"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"Brazilian company tax ID (CNPJ). 14 digits, with or without punctuation.","examples":["00000000000191","00.000.000/0001-91"]},"example":"00000000000191"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cnpj":"00000000000191","cnpj_formatted":"00.000.000/0001-91","legal_name":"BANCO DO BRASIL SA","trade_name":"DIRECAO GERAL","registration_status":"ACTIVE","incorporation_date":"1966-08-01","legal_nature":{"code":"2038","description_pt":"Sociedade Anônima","description_en":null},"main_activity":{"cnae_code":"6422100","description_pt":"Bancos múltiplos, com carteira comercial","description_en":null},"secondary_activities":[],"address":{"street":"SBS QUADRA 1","number":"S/N","city":"BRASILIA","state":"DF","zip":"70073901","country":"BR"},"simples_nacional":{"enrolled":false,"mei":false},"share_capital_brl":90000000000,"sources":[{"name":"minhareceita","fetched_at":"2026-07-02T00:00:00.000Z","ok":true}],"data_reference_date":"2024-01-01","disclaimer":"Public data aggregated from official Brazilian government sources."}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/company/{cnpj}/full":{"get":{"operationId":"lookupCompanyFull","summary":"Company full due-diligence profile (+ partners, sanctions)","description":"Full due-diligence profile of a Brazilian company: everything in the basic profile plus the complete quadro societário (QSA) — partner name, role and entry date, LGPD-safe with no CPF — and the same 5-registry screen as /risk: debarment (CEIS), anti-corruption (CNEP), leniency, impeded non-profits (CEPIM) and the forced-labor 'Lista Suja', with a verdict and 0-100 risk score. `sources_checked` names the registries that answered — an empty result is 'clear' only for those.","tags":["Companies"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.100000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"Brazilian company tax ID (CNPJ). 14 digits, with or without punctuation.","examples":["00000000000191","00.000.000/0001-91"]},"example":"00000000000191"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cnpj":"00000000000191","cnpj_formatted":"00.000.000/0001-91","legal_name":"BANCO DO BRASIL SA","trade_name":"DIRECAO GERAL","registration_status":"ACTIVE","incorporation_date":"1966-08-01","legal_nature":{"code":"2038","description_pt":"Sociedade Anônima","description_en":null},"main_activity":{"cnae_code":"6422100","description_pt":"Bancos múltiplos, com carteira comercial","description_en":null},"secondary_activities":[],"address":{"street":"SBS QUADRA 1","number":"S/N","city":"BRASILIA","state":"DF","zip":"70073901","country":"BR"},"simples_nacional":{"enrolled":false,"mei":false},"share_capital_brl":90000000000,"sources":[{"name":"minhareceita","fetched_at":"2026-07-02T00:00:00.000Z","ok":true}],"data_reference_date":"2024-01-01","disclaimer":"Public data aggregated from official Brazilian government sources.","partners":[{"name":"FULANO DE TAL","role_pt":"Diretor","role_en":"Director","entry_date":"2020-01-15"}],"sanctions":{"status":"checked","verdict":"clear","risk_score":0,"hit_count":0,"active_hit_count":0,"ceis":[],"cnep":[],"hits":[],"sources_checked":["CEIS","CNEP","ACORDOS_LENIENCIA","CEPIM","LISTA_SUJA"],"sources_unavailable":[],"data_as_of":[{"source":"CEIS","type":"live_query","as_of":"2024-01-01","update_frequency":"Portal da Transparência — refreshed ~daily upstream"}]}}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/risk/company/{cnpj}":{"get":{"operationId":"screenCompanyRisk","summary":"Brazilian regulatory risk & compliance screen (CEIS/CNEP/leniência)","description":"Brazilian regulatory risk & compliance screening of a company by CNPJ across 5 federal registries: debarment (CEIS), anti-corruption (CNEP), impeded non-profits (CEPIM), leniency (Acordos de Leniência) and forced-labor (Lista Suja, MTE). Returns a verdict + 0–100 risk score, each hit flagged active or historical, plus per-source data_as_of. The Brazilian complement global OFAC/EU/UK/UN + PEP screens miss. Company-level public data; no CPF; not legal advice.","tags":["Risk & compliance"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"Brazilian company tax ID (CNPJ). 14 digits, with or without punctuation.","examples":["00000000000191","00.000.000/0001-91"]},"example":"00000000000191"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cnpj":"38504819000169","cnpj_formatted":"38.504.819/0001-69","verdict":"flagged","risk_score":65,"hit_count":1,"active_hit_count":1,"hits":[{"list":"CEIS","category":"debarment","sanction_pt":"Suspensão","active":true,"start_date":"2025-10-15","end_date":"2027-10-15","sanctioning_body":"SERVICO FEDERAL DE PROCESSAMENTO DE DADOS","sphere":"FEDERAL","source":"Ministério da Fazenda","process":"PSI-2025/0000","publication_url":null}],"sources_checked":["CEIS","CNEP","ACORDOS_LENIENCIA","CEPIM","LISTA_SUJA"],"sources_unavailable":[],"data_as_of":[{"source":"CEIS","type":"live_query","as_of":"2026-07-08","update_frequency":"Portal da Transparência — refreshed ~daily upstream"},{"source":"CNEP","type":"live_query","as_of":"2026-07-08","update_frequency":"Portal da Transparência — refreshed ~daily upstream"},{"source":"ACORDOS_LENIENCIA","type":"live_query","as_of":"2026-07-08","update_frequency":"Portal da Transparência — updated as agreements change"},{"source":"CEPIM","type":"live_query","as_of":"2026-07-08","update_frequency":"Portal da Transparência — refreshed ~daily upstream"},{"source":"LISTA_SUJA","type":"snapshot","as_of":"2026-04-06","update_frequency":"MTE register — republished ~twice a year (Apr/Oct)"}],"data_policy":"Company-level public data only. No CPF is exposed (LGPD).","disclaimer":"Public federal registries: Portal da Transparência (CEIS/CNEP/CEPIM/Acordos de Leniência) and the MTE Cadastro de Empregadores / 'Lista Suja' (forced-labor register, Portaria Interministerial 18/2024 — periodic snapshot). Informational indicators from public sources, not legal advice, a compliance certification, or a guarantee; verify against the primary source before acting."}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/companies/search":{"post":{"operationId":"searchCompanies","summary":"Search & segment ~28M active companies (UNIQUE: mass discovery)","description":"Search and segment active Brazilian companies by industry (CNAE, main OR secondary), location, size, age, share capital and name. Returns official registry data with business contact info. Ideal for B2B lead generation and market research on Brazil. Priced per page ($0.05). CNAE accepts 4-7 digit prefixes, masked or not (6201-5/01 = 6201501). MEI contact data is redacted (LGPD).","tags":["Companies"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","description":"At least one content filter is required. Pagination is cursor-based (pass the returned next_cursor).","properties":{"cnae":{"type":"array","items":{"type":"string"},"description":"CNAE prefixes (4-7 digits), matched against the company's MAIN activity. Masked codes are accepted and normalized (\"6201-5/01\" = \"6201501\")."},"cnae_secondary":{"type":"array","items":{"type":"string"},"description":"CNAE prefixes (4-7 digits) matched against the company's SECONDARY activities. Matches if ANY secondary activity falls under ANY given prefix. Masked codes accepted."},"share_capital_min":{"type":"number","minimum":0,"description":"Declared share capital in BRL >= this."},"share_capital_max":{"type":"number","minimum":0,"description":"Declared share capital in BRL <= this."},"state":{"type":"string","description":"State (UF), 2 letters, e.g. \"MS\"."},"city":{"type":"string","description":"City name (accent/case-insensitive), or a TOM (4-digit) / IBGE (7-digit) code."},"company_size":{"type":"array","items":{"enum":["ME","EPP","DEMAIS"]}},"opened_before":{"type":"string","format":"date","description":"registration_date <= this (YYYY-MM-DD)."},"opened_after":{"type":"string","format":"date","description":"registration_date >= this (YYYY-MM-DD)."},"is_mei":{"type":["boolean","null"]},"name_contains":{"type":"string","minLength":2,"description":"Substring of the legal name (accent/case-insensitive)."},"has_email":{"type":["boolean","null"]},"has_phone":{"type":["boolean","null"]},"page_size":{"type":"integer","minimum":1,"maximum":50,"default":25},"cursor":{"type":["string","null"],"description":"Opaque cursor (a CNPJ). Pass the previous response's next_cursor."}}},"example":{"state":"MS","name_contains":"odontolog","page_size":5}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"results":[{"cnpj":"12345678000191","cnpj_formatted":"12.345.678/0001-91","legal_name":"CLINICA ODONTOLOGICA SORRISO LTDA","trade_name":"SORRISO ODONTO","main_activity":{"cnae_code":"8630501","description_pt":"Atividade odontológica"},"secondary_cnae_codes":["8640202","4772500"],"share_capital_brl":50000,"company_size":"ME","registration_date":"2019-03-10","address":{"street":"RUA DAS FLORES","number":"100","neighborhood":"CENTRO","city":"CAMPO GRANDE","state":"MS","zip":"79002000"},"email":"contato@sorrisoodonto.com.br","phones":["(67) 33334444"],"is_mei":false,"is_simples":true}],"next_cursor":"12345678000191","count_estimate":{"value":1000,"is_capped":true},"dump_reference_month":"2026-06-01","data_policy":"Company-level public registry data only. Source: Brazilian Federal Revenue open data."}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/nfe/{chave}":{"get":{"operationId":"decodeNfeKey","summary":"Decode an NF-e electronic invoice access key","description":"Decode any Brazilian electronic invoice (NF-e/NFC-e) 44-digit access key: issuer CNPJ, state, emission date, invoice number, model. Offline, deterministic, instant.","tags":["Documents"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"chave","in":"path","required":true,"schema":{"type":"string","description":"NF-e/NFC-e access key. 44 digits, with or without punctuation.","examples":["35250611444777000161550010000123451000000011"]},"example":"35250611444777000161550010000123451000000011"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"access_key":"35250611444777000161550010000123451000000011","document_type_description":"Brazilian electronic invoice (NF-e) access key","uf":{"code":"35","abbreviation":"SP","name":"São Paulo"},"emission_year_month":"2025-06","issuer_cnpj":"11444777000161","issuer_cnpj_formatted":"11.444.777/0001-61","model":{"code":"55","description":"NF-e (electronic invoice)"},"series":"001","invoice_number":"000012345","emission_type":{"code":"1","description":"Normal"},"numeric_code":"00000001","check_digit":"1"}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/boleto/decode":{"post":{"operationId":"decodeBoleto","summary":"Decode a boleto digitable line (amount, due date, bank)","description":"Decode Brazilian boleto payment slips (linha digitável): bank, amount, due date, validity check. Supports bank collection and utility/tax formats.","tags":["Documents"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"digitable_line":{"type":"string","description":"Boleto linha digitável: 47 digits (bank) or 48 digits (utility/tax)."}},"required":["digitable_line"]},"example":{"digitable_line":"34191234546789012345767890123457115030000012345"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"format":"bank_collection","bank_code":"341","bank_name":"Itaú Unibanco","currency_code":"9","amount_brl":123.45,"due_date":"2026-07-10","due_date_ambiguous":false,"due_date_factor":1503,"barcode":"34191150300000123451234567890123456789012345"}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/validate/batch":{"post":{"operationId":"validateDocuments","summary":"Batch-validate CPF/CNPJ/PIS/plate/Pix (up to 100)","description":"Batch-validate Brazilian identifiers: CPF, CNPJ (incl. new alphanumeric format), PIS, license plates, Pix keys. Up to 100 per call.","tags":["Documents"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.002000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"documents":{"type":"array","maxItems":100,"items":{"type":"object","properties":{"type":{"enum":["cpf","cnpj","pis","license_plate","pix_key"]},"value":{"type":"string"}},"required":["type","value"]}}},"required":["documents"]},"example":{"documents":[{"type":"cpf","value":"529.982.247-25"},{"type":"cnpj","value":"00.000.000/0001-91"}]}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"results":[{"type":"cpf","value_normalized":"52998224725","valid":true,"details":{}},{"type":"cnpj","value_normalized":"12ABC34501DE35","valid":true,"details":{"format":"alphanumeric","formatted":"12.ABC.345/01DE-35"}}],"summary":{"total":2,"valid":2,"invalid":0}}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/cep/{cep}":{"get":{"operationId":"lookupCep","summary":"Brazilian postal code (CEP) address lookup","description":"Brazilian postal code (CEP) lookup with English schema: full address, IBGE city code, coordinates when available.","tags":["Documents"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cep","in":"path","required":true,"schema":{"type":"string","description":"8-digit Brazilian postal code (CEP).","examples":["01310930"]},"example":"01310930"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cep":"01310930","street":"Avenida Paulista","neighborhood":"Bela Vista","city":"São Paulo","state":"SP","state_name":"São Paulo","ibge_city_code":"3550308","coordinates":{"latitude":-23.561684,"longitude":-46.655981},"sources":[{"name":"brasilapi","fetched_at":"2026-07-02T00:00:00.000Z","ok":true}]}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/tender/decode/{id}":{"get":{"operationId":"decodeTenderId","summary":"Decode a Compras.gov.br 17-digit tender id (offline)","description":"Offline decode of a Compras.gov.br 17-digit tender id (UASG + modality + number + year) into its parts, with the modality name in English. Deterministic, instant.","tags":["Public procurement"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.005000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"id","in":"path","required":true,"schema":{"type":"string","pattern":"^\\d{17}$","description":"Compras.gov.br 17-digit id: UASG(6)+modality(2)+number(5)+year(4).","examples":["98791305900292026"]},"example":"98791305900292026"}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"compras_id":"98791305900292026","uasg":"987913","modality":{"code":"05","description_pt":"Pregão","description_en":"Pregão (reverse auction; electronic or in-person)"},"number":"90029","year":2026}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/tender/resolve":{"post":{"operationId":"resolveTender","summary":"Resolve any tender reference to PNCP coordinates + summary","description":"Resolve any Brazilian public tender reference (Compras.gov.br 17-digit ID or URL, PNCP URL or control number) into canonical PNCP coordinates with a tender summary: object, modality, estimated value, opening/closing dates.","tags":["Public procurement"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.020000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"reference":{"description":"Any accepted tender reference: a Compras.gov.br 17-digit id or `?compra=` URL, a PNCP app/consulta URL, a PNCP control number (CNPJ-1-SEQ/ANO), or a coordinates object {cnpj, year, sequential}.","examples":["98791305900292026","https://pncp.gov.br/app/editais/75963850000194/2026/34","75963850000194-1-000034/2026"]}},"required":["reference"]},"example":{"reference":"98791305900292026"}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cnpj":"75963850000194","year":2026,"sequential":34,"control_number":"75963850000194-1-000034/2026","pncp_url":"https://pncp.gov.br/app/editais/75963850000194/2026/34","object":"Aquisição de equipamentos de rede","modality":{"code":"6","description_pt":"Pregão - Eletrônico","description_en":"Pregão (reverse auction) - Electronic"},"status":"Divulgada no PNCP","total_estimated_brl":140964.76,"opening_date":"2026-05-27T08:00:00","closing_date":"2026-06-11T09:00:00","buyer":{"cnpj":"75963850000194","name":"MUNICIPIO DE TEIXEIRA SOARES","uasg":"987913"},"is_srp":false}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/tender/{cnpj}/{year}/{seq}":{"get":{"operationId":"getTender","summary":"Public tender header (PNCP) by coordinates","description":"Full header of a Brazilian public tender by its PNCP coordinates (CNPJ/year/sequential): object, modality, status, estimated value, opening/closing dates, buyer, price-registration flag.","tags":["Public procurement"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"Buyer agency CNPJ (14 digits).","examples":["75963850000194"]},"example":"75963850000194"},{"name":"year","in":"path","required":true,"schema":{"type":"integer","minimum":2021,"examples":[2026]},"example":2026},{"name":"seq","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"PNCP sequential (NOT the Compras.gov.br number).","examples":[34]},"example":34}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"cnpj":"75963850000194","year":2026,"sequential":34,"control_number":"75963850000194-1-000034/2026","pncp_url":"https://pncp.gov.br/app/editais/75963850000194/2026/34","object":"Aquisição de equipamentos de rede","modality":{"code":"6","description_pt":"Pregão - Eletrônico","description_en":"Pregão (reverse auction) - Electronic"},"status":"Divulgada no PNCP","total_estimated_brl":140964.76,"opening_date":"2026-05-27T08:00:00","closing_date":"2026-06-11T09:00:00","buyer":{"cnpj":"75963850000194","name":"MUNICIPIO DE TEIXEIRA SOARES","uasg":"987913"},"is_srp":false}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/tender/{cnpj}/{year}/{seq}/items":{"get":{"operationId":"getTenderItems","summary":"Public tender line items + ME/EPP-exclusive flags","description":"Structured items of any Brazilian public tender (PNCP): quantities, maximum accepted prices, units, and SME-exclusive (ME/EPP) flags. Essential for bid/no-bid analysis. Paginates internally.","tags":["Public procurement"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.030000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"Buyer agency CNPJ (14 digits).","examples":["75963850000194"]},"example":"75963850000194"},{"name":"year","in":"path","required":true,"schema":{"type":"integer","minimum":2021,"examples":[2026]},"example":2026},{"name":"seq","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"PNCP sequential (NOT the Compras.gov.br number).","examples":[34]},"example":34}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"items_count":21,"total_estimated_brl":140964.76,"items":[{"item_number":1,"description":"Switch de rede gerenciável 24 portas","quantity":4,"unit":"Unidade","max_unit_price_brl":3200.5,"max_total_price_brl":12802,"me_epp_exclusive":true,"benefit_type_pt":"Participação exclusiva para ME/EPP"}]}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/tender/{cnpj}/{year}/{seq}/documents":{"get":{"operationId":"getTenderDocuments","summary":"Public tender document URIs (edital) — metadata only","description":"Document list (download URIs) of a Brazilian public tender (PNCP). ZIPs usually contain the full edital PDF and the item list. Metadata only — files are not fetched or served.","tags":["Public procurement"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"Buyer agency CNPJ (14 digits).","examples":["75963850000194"]},"example":"75963850000194"},{"name":"year","in":"path","required":true,"schema":{"type":"integer","minimum":2021,"examples":[2026]},"example":2026},{"name":"seq","in":"path","required":true,"schema":{"type":"integer","minimum":1,"description":"PNCP sequential (NOT the Compras.gov.br number).","examples":[34]},"example":34}],"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"documents":[{"name":"Edital.zip","uri":"https://pncp.gov.br/api/pncp/v1/orgaos/75963850000194/compras/2026/34/arquivos/1"}],"note":"ZIP files usually bundle the full edital (tender notice) PDF and the 'Relação de Itens'. Detailed item specs and lots/groups exist ONLY inside those PDFs, not in this JSON."}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/tender/search":{"post":{"operationId":"searchTenders","summary":"Search public tenders/licitações (PNCP) by keyword","description":"Search Brazilian public procurement tenders (PNCP) by keyword. Returns normalized tender references (CNPJ/year/sequential, control number, PNCP URL) ready for detail lookups.","tags":["Public procurement"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.050000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"query":{"type":"string","minLength":3,"description":"Keyword(s). Uses PNCP's own search filters."},"page":{"type":"integer","minimum":1,"default":1}},"required":["query"]},"example":{"query":"switch de rede","page":1}}}},"responses":{"200":{"description":"Successful response","content":{"application/json":{"schema":{"type":"object"},"example":{"results":[{"title":"Edital nº 90029/2026","buyer_cnpj":"75963850000194","uasg":"987913","year":2026,"sequential":34,"control_number":"75963850000194-1-000034/2026","pncp_url":"https://pncp.gov.br/app/editais/75963850000194/2026/34","date":"2026-05-20"}],"page":1}}}},"402":{"description":"Payment Required (x402). Pay to receive the response."}}}},"/validate/{cnpj}":{"get":{"operationId":"validateCnpj","summary":"Free CNPJ check-digit validation","tags":["Companies"],"security":[],"parameters":[{"name":"cnpj","in":"path","required":true,"schema":{"type":"string","description":"Brazilian company tax ID (CNPJ). 14 digits, with or without punctuation.","examples":["00000000000191","00.000.000/0001-91"]},"example":"00000000000191"}],"responses":{"200":{"description":"Validation result"}}}},"/health":{"get":{"operationId":"health","summary":"Health check","security":[],"responses":{"200":{"description":"OK"}}}}}}