Buscar oportunidades no PNCP

GET/v1/oportunidadesX-Api-Key

Descoberta por palavras e filtros explícitos na janela PNCP publicada. O status deriva do código de situação da fonte e dos prazos de proposta avaliados no instante fixado em meta. Fornecedores aparecem somente quando um resultado coletado identifica uma PJ por CNPJ exato; a publicação do edital não identifica vencedor. Nenhum resultado quer dizer só que nada corresponde ao recorte publicado, não que a oportunidade não existe. O exemplo é uma resposta oficial observada em um recorte limitado (um dia, DF, uma modalidade).

Parâmetros

qstring · query
Palavras no objeto e nas descrições dos itens; não aplica CNAE.
De 2 a 120 caracteres.
ufstring · query
UF explícita; deve pertencer ao manifesto da janela publicada.
Formato: ^[A-Z]{2}$.
municipio_ibgestring · query
Código IBGE de sete dígitos informado pelo PNCP.
Formato: ^[0-9]{7}$.
modalidadeinteger · query
Código PNCP explícito; deve pertencer ao manifesto da janela publicada.
Mínimo 1.
statusstring · query
Valores: futura, aberta, prazo_encerrado, prazo_indeterminado, revogada, anulada, suspensa, desconhecida.
prazo_destring (date) · query
Primeiro dia inclusivo do encerramento no calendário de Brasília.
prazo_atestring (date) · query
Último dia inclusivo do encerramento no calendário de Brasília.
limitinteger · query
Entre 1 e 100. Padrão: 20.
cursorstring · query
Cursor opaco vinculado à geração, aos filtros e a avaliado_em.

Resposta

Página vinculada à geração, aos filtros e ao instante de avaliação.

itemsarray de objeto
- numero_controle_pncpstring
- numero_comprastring | null
- ano_comprainteger
- objetostring
- itens_resumoarray de objeto
  - numero_iteminteger
  - descricaostring
  - situacao_fontestring | null
- itens_totalinteger
- contratanteobjeto
  - cnpjstring
  - nomestring | null
- localidadeobjeto
  - ufstring
  - municipio_ibgestring | null
  - municipiostring | null
- modalidadeobjeto
  - codigointeger
  - nomestring | null
- situacao_fonteobjeto
  - codigointeger | null
  - nomestring | null
- statusstring
  Valores: futura, aberta, prazo_encerrado, prazo_indeterminado, revogada, anulada, suspensa, desconhecida.
- data_abertura_propostastring | null (date-time)
- data_encerramento_propostastring | null (date-time)
- data_publicacao_pncpstring (date-time)
- data_atualizacaostring | null (date-time)
- valor_total_estimadostring | null
- url_fontestring (uri)
- fornecedores_identificadosarray de objeto
  - cnpjstring
  - nomestring | null
  - numero_iteminteger
  - situacao_resultadoobjeto
    - codigointeger | null
    - nomestring | null
  - data_resultadostring | null (date-time)
  - data_cancelamentostring | null (date-time)
  - motivo_cancelamentostring | null
  - url_fontestring (uri)
- fornecedores_totalinteger
has_moreboolean
next_cursorstring | null
metaobjeto
- fonte"PNCP"
- conjunto"pncp-oportunidades"
- snapshot_idstring
- geracaointeger
- cobertura"janela_completa_recortada"
- criterio"data_publicacao_pncp"
- data_inicialstring (date)
- data_finalstring (date)
- ufsarray de string
- modalidadesarray de integer
- consultado_emstring (date-time)
- avaliado_emstring (date-time)
- evidenciastring
  Valores: fixture_sintetica, live_nao_verificada, pncp_live_contrato_2026-09-25.
- contrato_fontestring
  Valores: documentado_nao_verificado_live, openapi_oficial_capturado.

Erros

Status	Quando	Código
401	Chave ausente, inválida ou revogada.
409	A geração do cursor deixou de ser a publicação atual.	`geracao_oportunidades_expirada`
422	Parâmetro ou cursor inválido, ou recorte fora da cobertura publicada.	`recorte_nao_coberto`
429	Cota diária da chave atingida (1.000 chamadas por padrão). Toda requisição autenticada conta, inclusive as que terminam em erro e as recusadas por cota. A contagem renova na virada do dia da base. A resposta não traz Retry-After.
503	Oportunidades sem janela completa publicada, autenticação indisponível, base indisponível, consulta interrompida pelo tempo limite ou consultas demais em andamento.	`oportunidades_indisponiveis` `base_indisponivel` `api_sobrecarregada` `consulta_demorada`

Formatos de erro em Erros; o que conta na cota em Autenticação e cota.

curl -G https://api.fonteza.com.br/v1/oportunidades \
  -H "X-Api-Key: $FONTEZA_KEY" \
  --data-urlencode "q=mobiliário"

import os
import requests

resposta = requests.get(
    "https://api.fonteza.com.br/v1/oportunidades",
    params={"q": "mobiliário"},
    headers={"X-Api-Key": os.environ["FONTEZA_KEY"]},
    timeout=30,
)
resposta.raise_for_status()
dados = resposta.json()

const url = new URL("https://api.fonteza.com.br/v1/oportunidades");
url.search = new URLSearchParams({ q: "mobiliário" });
const resposta = await fetch(url, {
  headers: { "X-Api-Key": process.env.FONTEZA_KEY },
});
if (!resposta.ok) throw new Error(`${resposta.status}: ${await resposta.text()}`);
const dados = await resposta.json();

Resposta 200

{
  "items": [
    {
      "numero_controle_pncp": "00489828000902-1-000019/2026",
      "numero_compra": "SPU/DF 020",
      "ano_compra": 2026,
      "objeto": "Alienação, mediante venda, de imóvel(eis) sob gestão da Secretaria do Patrimônio da União",
      "itens_resumo": [
        {
          "numero_item": 1,
          "descricao": "Apartamento - AOS 4 BLOCO D, 4 - Apartamento 313 da AOS 04 Bloco D - AREA OCTOGONAL - CEP: 70660-044 - Brasília - DF",
          "situacao_fonte": "Em andamento"
        }
      ],
      "itens_total": 1,
      "contratante": {
        "cnpj": "00489828000902",
        "nome": "MINISTERIO DA GESTAO E DA INOVACAO EM SERVICOS PUBLICOS"
      },
      "localidade": {
        "uf": "DF",
        "municipio_ibge": "5300108",
        "municipio": "Brasília"
      },
      "modalidade": {
        "codigo": 1,
        "nome": "Leilão - Eletrônico"
      },
      "situacao_fonte": {
        "codigo": 1,
        "nome": "Divulgada no PNCP"
      },
      "status": "aberta",
      "data_abertura_proposta": "2026-09-24T20:00:00+02:00",
      "data_encerramento_proposta": "2026-11-05T13:59:00+01:00",
      "data_publicacao_pncp": "2026-09-24T16:50:31+02:00",
      "data_atualizacao": "2026-09-24T16:50:31+02:00",
      "valor_total_estimado": "633434.97",
      "url_fonte": "https://pncp.gov.br/api/consulta/v1/orgaos/00489828000902/compras/2026/19",
      "fornecedores_identificados": [],
      "fornecedores_total": 0
    }
  ],
  "has_more": false,
  "next_cursor": null,
  "meta": {
    "fonte": "PNCP",
    "conjunto": "pncp-oportunidades",
    "snapshot_id": "pncpo-20260924-20260924-529544838db8de16",
    "geracao": 1,
    "cobertura": "janela_completa_recortada",
    "criterio": "data_publicacao_pncp",
    "data_inicial": "2026-09-24",
    "data_final": "2026-09-24",
    "ufs": [
      "DF"
    ],
    "modalidades": [
      1
    ],
    "consultado_em": "2026-09-25T11:53:26.251698Z",
    "avaliado_em": "2026-09-25T12:06:33.524502419Z",
    "evidencia": "pncp_live_contrato_2026-09-25",
    "contrato_fonte": "openapi_oficial_capturado"
  }
}

Nenhuma correspondência na janela publicada

json

{
  "items": [],
  "has_more": false,
  "next_cursor": null,
  "meta": {
    "fonte": "PNCP",
    "conjunto": "pncp-oportunidades",
    "snapshot_id": "pncpo-20260924-20260924-529544838db8de16",
    "geracao": 1,
    "cobertura": "janela_completa_recortada",
    "criterio": "data_publicacao_pncp",
    "data_inicial": "2026-09-24",
    "data_final": "2026-09-24",
    "ufs": [
      "DF"
    ],
    "modalidades": [
      1
    ],
    "consultado_em": "2026-09-25T11:53:26.251698Z",
    "avaliado_em": "2026-09-25T12:06:33.524502419Z",
    "evidencia": "pncp_live_contrato_2026-09-25",
    "contrato_fonte": "openapi_oficial_capturado"
  }
}