How can I use the API to retrieve the content of tender notices from the Public Procurement Bulletin (BZP) regarding a specific entity?

MGBI provides a comprehensive API for retrieving data from public registers and records, including the Public Procurement Bulletin (BZP).

You can find a list of data sources available through this service at:
👉Public Registers API

This guide coversthe Public Procurement Bulletin API, which we provide as part of the following product:
👉Public Procurement Bulletin API (BZP API)

Below, we describe how you canuse the API to retrieve the content of notices published in the Public Information Bulletin (BZP) for a specific entitybased on its registration number (NIP, REGON, or KRS).

Step 1: Obtain an API authorization key

To obtain the authorization key required to call the endpoints available in the MGBI API, please contact us using the contact form on the product page:
👉Public Procurement Bulletin API (BZP API)

Step 2: Call the Get Records endpoint

We make the data available in the BZP accessible via the MGBI API in the data model with the identifierpl-bzp-record.

The API provides aGet Records endpoint for this model, which returns records containing the content of BZP notices for entities that meet the specified criteria.
👉Documentation for the Get Records endpoint for the pl-bzp-record model

To retrieve a list of announcements for a single entity, you must provide its registration number—NIP, REGON, or KRS—in the Get Records endpoint.

Example of calling the Get Records endpoint with a tax ID number:

GET /v1/models/pl-bzp-record/records?identifiers.pl_nip=[NIP number] HTTP/1.1
Host: api.mgbi.pl
Authorization: [authorization key]

Step 3: Use the response to retrieve the list of notices from the Public Procurement Bulletin

A successful call to theGet Recordsendpoint returns a list of records that meet the specified criteria.

In the example above, the endpoint should return a list of results containing one or more records:

{
    "count": "[liczba wyników]",
    "pages": "[liczba stron wyników]",
    "results": [
        {
            "id": "[identyfikator rekordu]",
            "identifiers": "[identyfikatory podmiotu]",
            "content": "[treść ogłoszenia]",
            "notice": "[informacje o ogłoszeniu]",
            "meta": "[metadane rekordu]"
        }
    ]
}

Each record in the list contains a set of tender notices from the Public Procurement Bulletin (BZP) regarding the specified entity.

The most important information about the notice is available in thenotice glossary.

Contents of the "notice" dictionary for a single listing:

{
    "type": "[rodzaj ogłoszenia]",
    "number": "[numer ogłoszenia]",
    "poblication_datetime": "[data i czas publikacji]"
}

You can find all the detailed data available in the ad, as well as its HTML content, in thecontent.raw_result dictionary.

The contents of the content.raw_result dictionary for a single listing:

{
    "objectId": "[identyfikator ogłoszenia]",
    "clientType": "[rodzaj zamawiającego]",
    "orderType": "[rodzaj zamówienia]",
    "tenderType": "[tryb zamówienia]",
    "noticeType": "[rodzaj ogłoszenia]",
    "noticeNumber": "[numer ogłoszenia]",
    "bzpNumber": "[numer BZP]",
    "isTenderAmountBelowEU": "[tryb / rodzaj procedury]",
    "publicationDate": "[data publikacji]",
    "orderObject": "[nazwa zamówienia / nazwa konkursu]",
    "cpvCode": "[kod CPV]",
    "submittingOffersDate": "[termin składania ofert]",
    "procedureResult": "[wynik postępowania]",
    "organizationName": "[nazwa zamawiającego]",
    "organizationCity": "[miejscowość zamawiającego]",
    "organizationProvince": "[województwo zamawiającego]",
    "organizationCountry": "[kraj zamawiającego]",
    "organizationNationalId": "[krajowy numer identyfikacyjny]",
    "organizationId": "[identyfikator organizacji]",
    "tenderId": "[identyfikator postępowania]",
    "htmlBody": "[zawartość ogłoszenia w postaci HTML]",
    "contractors": "[lista wykonawców]"
}

Learn more:
👉Data structure in the pl-bzp-record model
👉Endpoint documentation for the pl-bzp-record model