Search Polish public tenders (BZP + TED) with filters.

Note: value_min/value_max filter on the estimated value and are known to be leaky at the API side (results slightly outside the range can appear).

Examples: search_tenders(search="komputer", city="Kraków", notice_type="ContractNotice") search_tenders(buyer_nip="6751199459", cpv="302", sort="newest") search_tenders(cpv="45", province="PL12", value_min=1000000, sort="value_desc")

Get full details of a tender by ID ('2026/BZP 00202613' or 'TED-123456-2026').

Set full=True to include the complete notice text (htmlBody) - it can be very large (tens of KB); default response excludes it.

Examples: get_tender("2026/BZP 00276746") get_tender("TED-279585-2026", full=True)

Get the full notice chain of a procurement procedure (announcement, revisions, result, contract performance) with dates and notice types.

Examples: get_tender_timeline("2023/BZP 00510245")

Get offer statistics for a tender: number of offers, lowest/highest/ winning prices, extracted from the result notice text (SEKCJA V).

Works best on TenderResultNotice / can-standard / ContractPerformingNotice IDs - use get_tender_timeline first to find the result notice of a procedure.

Examples: get_tender_offers("2023/BZP 00559582")

Extract contract/order money amounts from a tender notice full text.

Finds contract value, total paid, estimated value, part values and offer prices that the structured API fields do not expose. Amounts are returned as raw strings exactly as published (usually PLN).

Examples: extract_contract_value("2026/BZP 00278142")

Get a procuring entity (zamawiający) profile by NIP, optionally with the contractors that most frequently win its tenders.

Examples: get_buyer("6751199459") get_buyer("5252248481", include_winning_contractors=False)

Get a contractor (wykonawca) profile by NIP with win geography and, optionally, the buyers they most frequently win tenders from.

Examples: get_contractor("7781473428")

Search buyers (zamawiający) and contractors (wykonawcy) by name to find their NIP for get_buyer / get_contractor / search_tenders(buyer_nip=...).

Examples: search_entities("szpital dziecięcy") search_entities("budimex", entity_type="contractor")

Look up CPV (procurement category) codes by Polish keyword.

Examples: search_cpv("komputer") search_cpv("budowa drogi", limit=5)

Get aggregate statistics for a CPV category: tender count, average and median value, average offers count, average deadline length.

The response includes the actual days window the API applied - the upstream API sometimes ignores the requested window, so verify it.

Examples: get_category_stats("302") get_category_stats("45240000-1", window="quarter")

Get tender statistics: full province ranking (no args), one province, or a city drill-down with top buyers and top CPV categories.

Examples: get_province_stats() get_province_stats(province="PL12") get_province_stats(city="Kraków")

Escape hatch: GET any Atlas Przetargów API endpoint (path must start with /api/). Use for endpoints not covered by dedicated tools.

Examples: raw_request("/api/tenders/agg/provinces") raw_request("/api/entities/search", params_json='{"q": "gddkia"}')