Data

PNCP — Federal procurement: editais, contratos, vendor history

Direct access to Brazil's federal procurement portal (PNCP) and federal expenditure execution. Search editais (call-for-bids) and contratos by CNPJ, agency, modalidade, date range, UF, or IBGE municipal code. Returns typed responses with órgão, unidade, valor global, modalidade, sequencial, and PNCP permalinks.

Verified: 2026-05-02 (laranja-data-plane-audit-2026-05-02)

Risk Flags

  • LOW operational PNCP's API parameter shape evolves (e.g., codigo_municipio_ibge format). The wrapper validates inputs and returns clear errors.
  • LOW regulatory All PNCP data is public per the Lei de Acesso à Informação. Safe for high-volume background-screening workflows.

Cost

Type: Free · Free tier: Unlimited via auxiliar.ai gateway. PNCP upstream is open data.

Hidden costs

  • PNCP search returns paginated results — large CNPJ histories may need multiple round-trips.
  • Despesas execução data lags actual contract events by ~1 month due to publication cadence.

Install

Default

curl -s -H "Authorization: Bearer $AUXILIAR_TOKEN" "https://api.auxiliar.ai/api/invoke/pncp_contrato_buscar?cnpj_fornecedor=33000167000101&data_inicial=2023-01-01&data_final=2026-05-02"
# Federal contracts won by a Brazilian company (CNPJ-based search):
#   GET /api/invoke/pncp_contrato_buscar
#     params: cnpj_fornecedor, data_inicial (ISO YYYY-MM-DD), data_final,
#             pagina (default 1), tamanho_pagina (default 20), uf (optional)
#   GET /api/invoke/pncp_edital_buscar — date range + modalidade (optional)
#   GET /api/invoke/pncp_edital_detalhe — cnpj_orgao, ano, sequencial

Estimated time to first success: ~5 min

Dependencies

Minimum runtime: Any HTTP client

Composes with: Auxiliar.ai CNPJ fetch (BrasilAPI → CNPJ.ws cascade)

Distribution

Repository
https://github.com/Tlalvarez/Auxiliar-ai