search_requests >Search purchase requests
Search the requests (πρωτογενή αιτήματα) with which Greek public bodies start a purchase: what they intend to buy, under which CPV codes, for how much, and the approval record that follows. Every Greek public purchase is posted to ΚΗΜΔΗΣ in four acts, each with an ΑΔΑΜ code: the request (REQ, what a body wants to buy and its budget), the notice (PROC, the tender or invitation to bid), the contract (SYMV, what was signed and for how much) and the payment (PAY, what was paid). Returns a page of 50 acts, newest posting first, each with its ΑΔΑΜ, title, buying body, amounts, CPV codes and a link to the signed PDF; get_document has the full record and get_document_text reads the PDF. Filters combine with AND. A request is posted twice — once as the request itself and once as its approval — and `kind` picks either or both. IMPORTANT: ΚΗΜΔΗΣ searches at most 180 days of posting dates per call — the last 180 by default, and the most recent 180 of a longer range. Read `coverage` for what was searched; its note says where to continue. Amounts cannot be filtered upstream; read `total` on each act instead. A query upstream has not seen before over a wide window can take 15-30 s the first time; the same query answers at once afterwards. Use search_organizations to turn a body's name into `organizationId`.
Arguments
- titlestring, 2–100 characters
- Words from the act's title. Case and accents are ignored; matched as a phrase.
- organizationIdstring, matches ^\d+$
- Only acts of this body, by its uid from search_organizations — the same uids Διαύγεια uses.
- signerIdstring, matches ^\d+$
- Only acts signed by this official, by the uid in `signer.id` on an act.
- cpvstring, matches ^\d{8}-\d$
- Only acts with an item under this CPV code, e.g. '33600000-6' for pharmaceuticals. Exact code, not a prefix.
- contractTypestring, one of 9, 10, 12, 13, 14
- Kind of contract: '9' Υπηρεσίες, '10' Έργα, '12' Μελέτες, '13' Προμήθειες, '14' Τεχνικές και λοιπές συναφείς επιστημονικές υπηρεσίες.
- submittedFromstring, YYYY-MM-DD
- Earliest posting date, inclusive. ΚΗΜΔΗΣ searches at most 180 days per call — see `coverage`.
- submittedTostring, YYYY-MM-DD
- Latest posting date, inclusive.
- cancelledFromstring, YYYY-MM-DD
- Only acts cancelled on or after this date — with cancelledTo, lists cancellations.
- cancelledTostring, YYYY-MM-DD
- Only acts cancelled on or before this date.
- pageinteger, ≥ 0
- Zero-based page number. Pages hold 50 acts; defaults to 0.
- kindstring, one of initial, approval, all
- 'initial' the requests themselves, 'approval' their approval records, 'all' (default) both.
Example arguments
{
"organizationId": "5001",
"submittedFrom": "2026-08-01",
"submittedTo": "2026-08-31",
"kind": "initial"
}