Compabase Tenders API

The Tenders API from Compabase — 2 operation(s) for tenders.

GitHub OpenAPI

Operations 2

GET /tenders Public tenders in Poland (BZP + TED) #
GET /tenders/awards Largest recent contract awards #

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API
curl "https://apis.io/api/v1/apis/compabase:compabase-tenders-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"

Calls without X-API-Key need no key. Calls with it need a paid plan — get a key.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

compabase-tenders-api-openapi.yml Raw ↑
openapi: 3.2.0
info:
  title: Compabase Tenders API
  version: 1.0.0
  description: 'Operations tagged Tenders across 2 of this provider''s published API definitions: compabase-openapi.yaml, compabase-openapi.yaml. Each path carries the servers of the definition it was published in.'
servers:
- url: https://compabase.com/api/v1
  description: Full URL
tags:
- name: Tenders
paths:
  /tenders:
    get:
      tags:
      - Tenders
      summary: Public tenders in Poland (BZP + TED)
      description: 'Polish public tenders — national notices from the Public Procurement Bulletin (BZP) and EU-threshold notices

        for Poland from TED — with contracting authority, value, deadlines and (for awarded notices) the winner.'
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      parameters:
      - name: status
        in: query
        required: false
        schema:
          type: string
          enum:
          - open
          - awarded
        description: Open tenders or awarded contracts.
      - name: industry
        in: query
        required: false
        schema:
          type: string
        description: CPV group or 2-digit CPV division.
      - name: source
        in: query
        required: false
        schema:
          type: string
          enum:
          - national
          - eu
        description: National (BZP) or EU (TED) notices.
      - name: region
        in: query
        required: false
        schema:
          type: string
        description: Voivodeship.
      - name: city
        in: query
        required: false
        schema:
          type: string
        description: City of the contracting authority.
      - name: postal
        in: query
        required: false
        schema:
          type: string
        description: Postal code prefix.
      - name: kind
        in: query
        required: false
        schema:
          type: string
          enum:
          - supplies
          - services
          - works
        description: Contract type.
      - name: value_min
        in: query
        required: false
        schema:
          type: number
        description: Minimum estimated value (in `currency`).
      - name: value_max
        in: query
        required: false
        schema:
          type: number
        description: Maximum estimated value (in `currency`).
      - name: currency
        in: query
        required: false
        schema:
          type: string
          enum:
          - PLN
          - EUR
          - USD
        description: Currency of value filters and returned values.
      - name: limit
        in: query
        required: false
        schema:
          type: integer
          enum:
          - 6
          - 20
        description: Page size.
      - name: offset
        in: query
        required: false
        schema:
          type: integer
        description: Zero-based offset (max 2000).
      responses:
        '200':
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
          description: Page of tender notices.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                notices:
                - id: 08df390b-1847-1079-e2d6-6b000120cdb6
                  source: national
                  title: „Sukcesywna dostawa w latach 2026-2027 własnym transportem oleju opałowego do celów grzewczych budynku w Mierczycach , 59-430 Mierczyce 34.”
                  buyer_name: DOM Pomocy Społecznej w Jaworze
                  buyer_city: Jawor
                  buyer_nip: '6141180562'
                  cpv_code: 09135100-5 (Olej opałowy)
                  publication_date: '2026-11-02'
                  deadline: '2026-11-10T16:00:00.000Z'
                  days_left: 0
                - id: 08df399e-2249-6935-e2d6-6b000120d994
                  source: national
                  title: Przedłużenie licencji na aktualizację i wsparcie techniczne FortiGate, FortiMail, FortiAnalyzer oraz FortiSwitch dla MOPS w Krakowie.
                  buyer_name: Gmina Miejska Kraków
                  buyer_city: Kraków
                  buyer_nip: '6761013717'
                  cpv_code: 32420000-3 (Urządzenia sieciowe),48761000-0 (Pakiety oprogramowania antywirusowego),48000000-8 (Pakiety oprogramowania i systemy informat…
                  publication_date: '2026-11-03'
                  deadline: '2026-11-11T07:00:00.000Z'
                  days_left: 1
                total: 15406
                limit: 20
                offset: 0
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      operationId: getTenders
      x-operation-id-source: derived
    servers:
    - url: https://compabase.com/api/v1
      description: Full URL
  /tenders/awards:
    get:
      tags:
      - Tenders
      summary: Largest recent contract awards
      description: Largest recent public contract awards in Poland with the winning company (KRS when matched).
      security:
      - ApiKeyAuth: []
      - BearerAuth: []
      parameters:
      - name: industry
        in: query
        required: false
        schema:
          type: string
          enum:
          - it
          - construction
          - medicine
        description: Industry filter.
      - name: min
        in: query
        required: false
        schema:
          type: integer
          enum:
          - 0
          - 100000
          - 1000000
          - 5000000
          - 10000000
        description: Minimum contract value in PLN (default 1000000).
      responses:
        '200':
          headers:
            X-RateLimit-Limit:
              $ref: '#/components/headers/X-RateLimit-Limit'
            X-RateLimit-Remaining:
              $ref: '#/components/headers/X-RateLimit-Remaining'
            X-RateLimit-Reset:
              $ref: '#/components/headers/X-RateLimit-Reset'
          description: Recent awards, largest first.
          content:
            application/json:
              schema:
                type: object
                additionalProperties: true
              example:
                awards:
                - winner_name: Panorama Obiekty Sportowe
                  amount_pln: 1325000
                  buyer_name: Gmina Brzeszcze
                  registry_number: 0000438344
                  entity_id: dedc4a42-615d-41e9-848f-7233fbcfd252
                - winner_name: Quoos
                  amount_pln: 9927501.23
                  buyer_name: Gmina Bielawa
                  registry_number: '0001023335'
                  entity_id: 234b5203-9308-485e-b64b-ca1c20fc0569
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '429':
          $ref: '#/components/responses/TooManyRequests'
      operationId: getTendersAwards
      x-operation-id-source: derived
    servers:
    - url: https://compabase.com/api/v1
      description: Full URL
components:
  responses:
    Unauthorized:
      description: Missing, invalid, or revoked API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            statusCode: 401
            statusMessage: Unauthorized
            message: Unauthorized
            data:
              message: Missing or invalid API key.
    BadRequest:
      description: Invalid request parameters.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            invalidKrs:
              summary: Invalid KRS value
              value:
                statusCode: 400
                statusMessage: Invalid krs
                message: Invalid krs
                data:
                  error:
                    code: INVALID_KRS
                    message: After normalization, KRS must contain exactly 10 digits.
                    details:
                      parameter: krs
            invalidCursor:
              summary: Invalid cursor format
              value:
                statusCode: 400
                statusMessage: Invalid cursor
                message: Invalid cursor
                data:
                  error:
                    code: INVALID_CURSOR
                    message: Cursor must be a valid UUID.
                    details:
                      parameter: cursor
            invalidRange:
              summary: Invalid numeric range
              value:
                statusCode: 400
                statusMessage: Invalid range
                message: Invalid range
                data:
                  error:
                    code: INVALID_RANGE
                    message: revenue_min cannot be greater than revenue_max.
                    details:
                      parameter: revenue_min,revenue_max
    TooManyRequests:
      description: 'Rate limit (120 requests per minute per key) or monthly quota exceeded.

        `Retry-After` says how many seconds to wait before retrying.

        '
      headers:
        Retry-After:
          $ref: '#/components/headers/Retry-After'
        X-RateLimit-Limit:
          $ref: '#/components/headers/X-RateLimit-Limit'
        X-RateLimit-Remaining:
          $ref: '#/components/headers/X-RateLimit-Remaining'
        X-RateLimit-Reset:
          $ref: '#/components/headers/X-RateLimit-Reset'
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            statusCode: 429
            statusMessage: Too Many Requests
            message: Too Many Requests
            data:
              error:
                code: QUOTA_EXCEEDED
                message: Monthly quota exceeded for this API key.
  headers:
    X-RateLimit-Remaining:
      description: Requests left in the current one-minute window.
      schema:
        type: integer
      example: 117
    Retry-After:
      description: Seconds to wait before retrying.
      schema:
        type: integer
      example: 30
    X-RateLimit-Limit:
      description: Requests allowed per minute for this API key.
      schema:
        type: integer
      example: 120
    X-RateLimit-Reset:
      description: Seconds until the current one-minute window resets.
      schema:
        type: integer
      example: 42
  schemas:
    ErrorResponse:
      type: object
      required:
      - statusCode
      - statusMessage
      - message
      properties:
        statusCode:
          type: integer
          description: HTTP status code.
        statusMessage:
          type: string
          description: HTTP status text.
        message:
          type: string
          description: Short error summary (same as statusMessage for most errors).
        data:
          type: object
          description: Domain error payload set by the handler.
          properties:
            message:
              type: string
              description: Human-readable message (used by 401 responses).
            error:
              type: object
              description: Structured domain error (used by 400/404/429 responses).
              properties:
                code:
                  type: string
                  description: Machine-readable domain error code.
                  enum:
                  - INVALID_KRS
                  - INVALID_NIP
                  - INVALID_CURSOR
                  - INVALID_RANGE
                  - INVALID_PARAMETER
                  - CONFLICTING_PARAMETERS
                  - INVALID_BOOLEAN
                  - INVALID_KEYWORDS
                  - INVALID_API_KEY
                  - UNAUTHORIZED
                  - NOT_FOUND
                  - QUOTA_EXCEEDED
                message:
                  type: string
                details:
                  type: object
                  additionalProperties: true
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-API-Key
    BearerAuth:
      type: http
      scheme: bearer
x-refined-from:
- compabase-openapi.yaml
- compabase-openapi.yaml