pncp-dev API

openapi: 3.1.0
info:
  title: pncp-dev API
  version: '2026-10-30'
  description: 'GENERATED FROM DOCUMENTATION by API Evangelist on 2026-10-30: 4 operation(s) read from 4 public documentation page(s) (each operation
    names its page in x-source). This is not the provider''s published contract; pncp-dev has published no machine-readable contract that the
    pipeline could find. Engine: anthropic.'
  x-evidence-tiers:
    code-example: 3
    documentation: 1
    pages-with-code: 4
    pages-read: 4
  x-generated-from: documentation
  x-provenance: generated
  x-authored-by: API Evangelist
  x-generated: '2026-10-30'
  x-generator: generate-contract-from-docs.py
  x-engine: anthropic
  x-sources:
  - https://pncp.dev/docs
  - https://pncp.dev/exemplos
  - https://pncp.dev/status
  - https://pncp.dev/docs/mcp
servers:
- url: https://api.pncp.dev
paths:
  /_/status:
    get:
      operationId: get_status
      tags:
      - API
      summary: GET /_/status
      x-source: https://pncp.dev/docs
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: javascript
        snippet: "fetch(\"https://api.pncp.dev/_/status\", {\n signal: AbortSignal.timeout(5000),\n cache: \"no-store\"\n })"
  /api/consulta/v1/contratacoes/publicacao:
    get:
      operationId: get_api_consulta_v1_contratacoes_publicacao
      tags:
      - Api
      summary: GET /api/consulta/v1/contratacoes/publicacao
      x-source: https://pncp.dev/docs
      parameters:
      - name: codigoModalidadeContratacao
        in: query
        required: false
        schema:
          type: string
      - name: dataFinal
        in: query
        required: false
        schema:
          type: string
      - name: dataInicial
        in: query
        required: false
        schema:
          type: string
      - name: pagina
        in: query
        required: false
        schema:
          type: string
      - name: tamanhoPagina
        in: query
        required: false
        schema:
          type: string
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: 'curl "https://api.pncp.dev/api/consulta/v1/contratacoes/publicacao?dataInicial=20261022&dataFinal=20261028&codigoModalidadeContratacao=6&pagina=1&tamanhoPagina=10"  -H
          "x-api-key: $PNCP_API_KEY" A resposta é o JSON do PNCP, sem nenhuma alteração. Criar chave grátis Ver exemplos rodando Sua chave Toda
          chamada precisa da sua chave. O melhor jeito de mandar é no header x-api-key : header copiar x-api'
  /api/consulta/v1/orgaos:
    get:
      operationId: get_api_consulta_v1_orgaos
      tags:
      - Api
      summary: Returns government agencies.
      x-source: https://pncp.dev/docs
      parameters:
      - name: pagina
        in: query
        required: false
        schema:
          type: integer
      - name: tamanhoPagina
        in: query
        required: false
        schema:
          type: integer
        description: Page size, minimum 10
      - name: x-api-key
        in: header
        required: false
        schema:
          type: string
        description: API key for authentication
      - name: api_key
        in: query
        required: false
        schema:
          type: string
        description: Alternative way to pass API key via URL parameter
      responses:
        '200':
          description: Success (status as documented)
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/GetApiConsultaV1OrgaosResponse'
      x-evidence:
        kind: documentation
  /oauth/device_authorization:
    get:
      operationId: get_oauth_device_authorization
      tags:
      - Oauth
      summary: GET /oauth/device_authorization
      x-source: https://pncp.dev/docs/mcp
      responses:
        '200':
          description: Success (status as documented)
      x-evidence:
        kind: code-example
        language: curl
        snippet: curl https://api.pncp.dev/oauth/device_authorization  -d client_id=pncp-cli -d resource=https://api.pncp.dev/mcp Desconecte e
          proteja sua conta Para cortar o acesso, abra Chaves no painel e revogue a chave com o nome do app. Desconectar apenas no app de IA pode
          deixar a chave ativa no pncp.dev. O app recebe os resultados das ferramentas que você autorizar. A consulta get_usage inclui a cota
          e os c
components:
  schemas:
    GetApiConsultaV1OrgaosResponse:
      type: object
      properties:
        x-quota-limit:
          type: integer
          description: Monthly quota limit
        x-quota-remaining:
          type: integer
          description: Remaining quota for the month
        x-quota-reset:
          type: integer
          description: UNIX timestamp when quota resets
        x-pncp-dev:
          type: string
          description: Status of the request (hit, cache, auth, quota, denied, method, waf-blocked, upstream-error)
  securitySchemes:
    apiKey:
      type: apiKey
      in: header
      name: x-api-key
security:
- apiKey: []
tags:
- name: API
- name: Api
- name: Oauth