> ## Documentation Index > Fetch the complete documentation index at: https://docs.krdata.pl/llms.txt > Use this file to discover all available pages before exploring further. # Pobieranie wielu rekordów > Ogłoszenia z Biuletynu Zamówień Publicznych wyszukane po jednym lub wielu identyfikatorach. Parametr `q` można przekazać wielokrotnie (do 50 wartości): KRS, NIP, UUID (firmy lub ogłoszenia) albo numer BZP (np. `2026/BZP 00373727`). NIP jest dopasowywany zarówno do zamawiającego, jak i do wykonawców (wygrane przetargi). Wspiera filtry: rodzaj ogłoszenia, zakres dat oraz tryby pełny/lekki (`include_details`). Każdy zwrócony rekord = 1 jednostka puli **BZP**. Wymaga planu Pro lub wyższego. ## OpenAPI ````yaml /openapi.json get /v1/bzp/records openapi: 3.1.0 info: title: krdata API description: > krdata udostępnia dane z polskich rejestrów gospodarczych (KRS, CRBR, KRZ, MSiG, RDF, biała lista VAT) w postaci jednego, spójnego API. Uwierzytelnianie odbywa się przez klucz API przekazywany w nagłówku `x-api-key`. Limity zapytań oraz pule (RDF, PDF, WPV, raporty) wynikają z wybranego abonamentu — szczegóły zwraca endpoint `GET /v1/usage/summary`. version: 0.1.0 servers: - url: https://api.krdata.pl description: Production security: [] paths: /v1/bzp/records: get: tags: - BZP summary: Pobieranie wielu rekordów description: >- Ogłoszenia z Biuletynu Zamówień Publicznych wyszukane po jednym lub wielu identyfikatorach. Parametr `q` można przekazać wielokrotnie (do 50 wartości): KRS, NIP, UUID (firmy lub ogłoszenia) albo numer BZP (np. `2026/BZP 00373727`). NIP jest dopasowywany zarówno do zamawiającego, jak i do wykonawców (wygrane przetargi). Wspiera filtry: rodzaj ogłoszenia, zakres dat oraz tryby pełny/lekki (`include_details`). Każdy zwrócony rekord = 1 jednostka puli **BZP**. Wymaga planu Pro lub wyższego. operationId: bzp-records parameters: - name: q in: query required: true schema: type: array items: type: string minLength: 4 maxLength: 64 description: >- Company identifier or notice reference: KRS or NIP (10-digit, optionally prefixed with 'krs:' or 'nip:'), UUID (companies.id or notice objectId), or BZP number (e.g. '2026/BZP 00373727'). NIP is matched against both the contracting authority and contractors. title: Q description: >- Company identifier or notice reference: KRS or NIP (10-digit, optionally prefixed with 'krs:' or 'nip:'), UUID (companies.id or notice objectId), or BZP number (e.g. '2026/BZP 00373727'). NIP is matched against both the contracting authority and contractors. - name: notice_type in: query required: false schema: anyOf: - type: string maxLength: 48 - type: 'null' title: Notice Type - name: from in: query required: false schema: anyOf: - type: string format: date - type: 'null' title: From - name: to in: query required: false schema: anyOf: - type: string format: date - type: 'null' title: To - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 20 title: Limit - name: offset in: query required: false schema: type: integer minimum: 0 default: 0 title: Offset - name: include_details in: query required: false schema: type: boolean default: true title: Include Details responses: '200': description: Successful Response content: application/json: schema: anyOf: - $ref: '#/components/schemas/BzpRecordPage' - $ref: '#/components/schemas/BzpListPage' title: Response Bzp-Records '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' security: - APIKeyHeader: [] components: schemas: BzpRecordPage: properties: items: items: $ref: '#/components/schemas/BzpNotice' type: array title: Items limit: type: integer title: Limit offset: type: integer title: Offset has_more: type: boolean title: Has More type: object required: - items - limit - offset - has_more title: BzpRecordPage BzpListPage: properties: items: items: $ref: '#/components/schemas/BzpListRow' type: array title: Items limit: type: integer title: Limit offset: type: integer title: Offset has_more: type: boolean title: Has More type: object required: - items - limit - offset - has_more title: BzpListPage HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError BzpNotice: properties: id: type: string format: uuid title: Id notice_type: type: string title: Notice Type notice_number: anyOf: - type: string - type: 'null' title: Notice Number bzp_number: anyOf: - type: string - type: 'null' title: Bzp Number is_below_eu: anyOf: - type: boolean - type: 'null' title: Is Below Eu publication_date: type: string format: date-time title: Publication Date order_object: anyOf: - type: string - type: 'null' title: Order Object cpv_codes: anyOf: - type: string - type: 'null' title: Cpv Codes submitting_offers_date: anyOf: - type: string format: date-time - type: 'null' title: Submitting Offers Date procedure_result: anyOf: - type: string - type: 'null' title: Procedure Result client_type: anyOf: - type: string - type: 'null' title: Client Type order_type: anyOf: - type: string - type: 'null' title: Order Type tender_type: anyOf: - type: string - type: 'null' title: Tender Type organization_name: anyOf: - type: string - type: 'null' title: Organization Name organization_city: anyOf: - type: string - type: 'null' title: Organization City organization_province: anyOf: - type: string - type: 'null' title: Organization Province organization_country: anyOf: - type: string - type: 'null' title: Organization Country organization_national_id: anyOf: - type: string - type: 'null' title: Organization National Id organization_nip: anyOf: - type: string - type: 'null' title: Organization Nip company_id: anyOf: - type: string format: uuid - type: 'null' title: Company Id tender_id: anyOf: - type: string - type: 'null' title: Tender Id tender_url: anyOf: - type: string - type: 'null' title: Tender Url tender_platform: anyOf: - type: string - type: 'null' title: Tender Platform contractors: anyOf: - items: $ref: '#/components/schemas/BzpContractor' type: array - type: 'null' title: Contractors text_body: anyOf: - type: string - type: 'null' title: Text Body metadata: $ref: '#/components/schemas/Metadata' type: object required: - id - notice_type - publication_date - metadata title: BzpNotice BzpListRow: properties: id: type: string format: uuid title: Id notice_type: type: string title: Notice Type bzp_number: anyOf: - type: string - type: 'null' title: Bzp Number publication_date: type: string format: date-time title: Publication Date order_object: anyOf: - type: string - type: 'null' title: Order Object organization_name: anyOf: - type: string - type: 'null' title: Organization Name organization_city: anyOf: - type: string - type: 'null' title: Organization City organization_province: anyOf: - type: string - type: 'null' title: Organization Province organization_nip: anyOf: - type: string - type: 'null' title: Organization Nip company_id: anyOf: - type: string format: uuid - type: 'null' title: Company Id submitting_offers_date: anyOf: - type: string format: date-time - type: 'null' title: Submitting Offers Date contractor_nips: anyOf: - items: type: string type: array - type: 'null' title: Contractor Nips type: object required: - id - notice_type - publication_date title: BzpListRow ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type input: title: Input ctx: type: object title: Context type: object required: - loc - msg - type title: ValidationError BzpContractor: properties: name: anyOf: - type: string - type: 'null' title: Name city: anyOf: - type: string - type: 'null' title: City province: anyOf: - type: string - type: 'null' title: Province country: anyOf: - type: string - type: 'null' title: Country national_id: anyOf: - type: string - type: 'null' title: National Id type: object title: BzpContractor Metadata: properties: first_seen: type: string format: date-time title: First Seen last_updated: type: string format: date-time title: Last Updated source_updated_at: anyOf: - type: string format: date-time - type: 'null' title: Source Updated At type: object required: - first_seen - last_updated title: Metadata securitySchemes: APIKeyHeader: type: apiKey in: header name: x-api-key ````