Get Records - Dokumentacja MGBI API

Pobiera rekordy z informacjami o ogłoszeniach z Biuletynu Zamówień Publicznych (BZP) spełniające podane kryteria.

W przypadku sukcesu w odpowiedzi zwraca paginowaną listę rekordów.

W przypadku braku rekordów spełniających podane kryteria zwraca pustą listę.

Poprawne wywołanie endpointu zwiększa liczniki:

api i api_search o 1

api_search_results o 1 jeśli zwrócono co najmniej jeden rekord

records i records_api_search o liczbę zwróconych rekordów

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Successful Response

application/json

Lista rekordów

Body

Example

{
    "count": 0,
    "pages": 0,
    "results": [
        {
            "content": {
                "raw_result": {
                    "bzpNumber": "2023/BZP 00225616",
                    "clientType": "1.1.15",
                    "cpvCode": "45000000-7 (Roboty budowlane),45453000-7 (Roboty remontowe i renowacyjne),45421000-4 (Roboty w zakresie stolarki budowlanej),45421100-5 (Instalowanie drzwi i okien, i podobnych elementów),45421110-8 (Instalowanie ram drzwiowych i okiennych),45421130-4 (Instalowanie drzwi i okien),45421132-8 (Instalowanie okien)",
                    "htmlBody": "<html><head>...",
                    "isTenderAmountBelowEU": true,
                    "noticeNumber": "2023/BZP 00225616/01",
                    "noticeType": "ContractNotice",
                    "objectId": "08db5a84-3e17-92ea-d0a9-9e0012b8d74a",
                    "orderObject": "Modernizacja stolarki okiennej elewacji południowej i wieży zegarowej gmachu głównego w Centrum Kultury ZAMEK w Poznaniu. Etap 2.",
                    "orderType": "Works",
                    "organizationCity": "Poznań",
                    "organizationCountry": "PL",
                    "organizationId": "4913",
                    "organizationName": "Centrum Kultury ZAMEK",
                    "organizationNationalId": "7781019907",
                    "organizationProvince": "PL30",
                    "publicationDate": "2023-05-22T05:20:22.68Z",
                    "submittingOffersDate": "2023-06-06T06:00:00Z",
                    "tenderId": "ocds-148610-181c0de1-f85a-11ed-9355-06954b8c6cb9",
                    "tenderType": "1.1.2"
                }
            },
            "id": "69944d67becc0528b426e6ee",
            "identifiers": {
                "pl_nip": "7781019907",
                "pl_regon": "000278178"
            },
            "meta": {
                "first_update_datetime": "2026-02-17T11:13:41.491Z",
                "last_update_datetime": "2026-02-17T12:04:14.477Z"
            },
            "notice": {
                "number": "2023/BZP 00225616/01",
                "publication_datetime": "2023-05-22T05:20:22.680Z",
                "type": "ContractNotice"
            }
        }
    ]
}

🟠400Bad Request

🟠401Unauthorized

🟠403Forbidden

🟠404Not Found

🟠429Too Many Requests