list_releases
Filter and list OCDS procurement releases by criteria like month, CPV code, buyer, value, and method to discover tenders for detailed analysis.
Instructions
List and filter OCDS procurement releases by structured criteria: month, CPV code prefix, procurement category, procurement method, value range, and buyer name. Supports pagination. Data is fetched from the REST API. Use this for tender discovery before drilling into specific releases with get_release.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| buyer_name | No | Filter by buyer name (case-insensitive substring match) | |
| cpv_prefix | No | Filter by CPV code prefix (e.g. '45' for construction, '72' for IT) | |
| deadline_after | No | Only include tenders with deadline on or after this ISO-8601 datetime | |
| deadline_before | No | Only include tenders with deadline on or before this ISO-8601 datetime | |
| eu_funded | No | Filter by EU funding status (true = EU funded) | |
| has_awards | No | Filter by whether the release has awards with suppliers (true/false) | |
| limit | No | Maximum number of results (default 20, max 200) | |
| location_nuts | No | Filter by delivery location NUTS code prefix (e.g. 'DE3' for Berlin) | |
| main_procurement_category | No | Filter by main procurement category (e.g. 'works', 'goods', 'services') | |
| month | No | Filter by month in YYYY-MM format | |
| nuts_code | No | Filter by NUTS code prefix (e.g. 'DE2' for Baden-Württemberg) | |
| offset | No | Offset for pagination (default 0) | |
| procurement_method | No | Filter by procurement method (e.g. 'open', 'selective', 'limited') | |
| result_code | No | Filter by result code (e.g. 'selec-w' for selected winner, 'clos-nw' for closed no winner) | |
| status | No | Filter by tender status (e.g. 'active', 'complete', 'cancelled') | |
| submission_deadline_after | No | Only include tenders with submission deadline on or after this ISO-8601 datetime | |
| submission_deadline_before | No | Only include tenders with submission deadline on or before this ISO-8601 datetime | |
| tag | No | Filter by lifecycle tag (e.g. 'tender', 'award', 'planning') | |
| value_max | No | Maximum tender value | |
| value_min | No | Minimum tender value |