POST /api/kimdis/notices/search
Price: 10 credits
Search Greek public contract notices in the KIMDIS registry by title, CPV code, contracting authority, deciding body, contract type, procedure, registration date, submission deadline, value, cancellation date and funding code. Returns the full notice record, newest first.
Without `date_from`/`date_to` the search covers the last 180 days of registrations; pass `date_from` to reach back as far as 2017. Codes for `organization_ids`, `signer_id` and `procedure_type` are the `code` values the rows carry.
access-token string requiredtimeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)cpv_codes array — CPV codes, any of (default: []; examples: ["45000000-7"])organization_ids array — Contracting authority codes, as in `organization.code` (default: []; examples: ["100015981"])signer_id string nullable — Deciding body code, as in `signer.code` (examples: "100092497"; pattern: ^[1-9]\d*$)contract_type string nullable — Main character of the contract (one of: "services", "works", "studies", "supplies", "technical_services")date_from string nullable — Registered in the registry on or after (format: date; examples: "2026-09-01")date_to string nullable — Registered in the registry on or before (format: date; examples: "2026-09-07")min_total_cost number nullable — Lowest total value without VAT, EUR (min: 0)max_total_cost number nullable — Highest total value without VAT, EUR (min: 0)cancelled_from string nullable — Cancelled on or after (format: date; examples: "2026-06-01")cancelled_to string nullable — Cancelled on or before (format: date; examples: "2026-09-20")offset integer — Rows to skip (default: 0; min: 0)procedure_type string nullable — Procedure type code, as in `procedure_type.code` (examples: "1"; pattern: ^[1-9]\d*$)deadline_from string nullable — Tender submission deadline on or after (format: date; examples: "2026-10-01")deadline_to string nullable — Tender submission deadline on or before (format: date; examples: "2026-10-31")invoicing_code string nullable — Authority e-invoicing code, as in `invoicing_code` (examples: "1015.E00808.0001"; maxLength: 30)public_investment_project_number string nullable — Public Investment Programme project number, as in `funding` (maxLength: 30)only_amendments boolean — Only notices that amend an earlier notice (default: false)count integer required — Max number of notices to return (min: 1; max: 1000)@type string (default: "KimdisNotice")id string requireddocument_url string nullableorganization object nullable@type string (default: "KimdisCode")code string nullablename string nullableorganization_vat_number string nullableis_greek_organization_vat_number boolean nullableinvoicing_code string nullableunits_operator object nullable@type string (default: "KimdisCode")code string nullablename string nullablesigner object nullable@type string (default: "KimdisCode")code string nullablename string nullableauthor_email string nullableprotocol_number string nullablesigned_date string nullablesubmitted_at integer nullableupdated_at integer nullableis_cancelled boolean nullablecancelled_at integer nullablecancellation_type string nullablecancellation_reason string nullablecancellation_ada string nullablecontract_type object nullable@type string (default: "KimdisCode")code string nullablename string nullableadditional_contract_types array (default: [])@type string (default: "KimdisCode")code string nullablename string nullableis_mixed_contract boolean nullablenuts object nullable@type string (default: "KimdisCode")code string nullablename string nullablenuts_regions array (default: [])@type string (default: "KimdisCode")code string nullablename string nullablecity string nullablepostal_code string nullablecountry object nullable@type string (default: "KimdisCode")code string nullablename string nullableauthority_type object nullable@type string (default: "KimdisCode")code string nullablename string nullablepublic_law_classification object nullable@type string (default: "KimdisCode")code string nullablename string nullableauthority_activity object nullable@type string (default: "KimdisCode")code string nullablename string nullablelegal_context object nullable@type string (default: "KimdisCode")code string nullablename string nullablecentralized_markets array (default: [])@type string (default: "KimdisCode")code string nullablename string nullableis_central_government boolean nullableis_reserved_contract boolean nullableis_social_contract boolean nullabletotal_cost_with_vat number nullabletotal_cost_without_vat number nullablebudget number nullablecommitment_number string nullablefunding object nullable@type string (default: "KimdisFunding")public_investment_code string nullablepublic_investment_project_number string nullablepublic_investment_ops_code string nullablecofunded_program string nullableself_funded_program string nullableespa_program string nullableregular_budget_program string nullableline_items array (default: [])@type string (default: "KimdisItem")description string nullablequantity number nullableunit object nullable@type string (default: "KimdisCode")code string nullablename string nullablecost_without_vat number nullablevat_rate number nullablecurrency string nullablecpvs array (default: [])@type string (default: "KimdisCode")code string nullablename string nullablegreen_procurement object nullable@type string (default: "KimdisCode")code string nullablename string nullablegoods_or_services object nullable@type string (default: "KimdisCode")code string nullablename string nullablebudget_code string nullablerequest_id string nullabledelivery_address string nullabledelivery_street_number string nullabledelivery_postal_code string nullabledelivery_city string nullabledelivery_country object nullable@type string (default: "KimdisCode")code string nullablename string nullableconstruction_city object nullable@type string (default: "KimdisCode")code string nullablename string nullablecontractor_name string nullablecontractor_vat_number string nullableis_greek_contractor_vat_number boolean nullablecontractor_country object nullable@type string (default: "KimdisCode")code string nullablename string nullableinvoice_number string nullablecommitment_code string nullablenotice_type object nullable@type string (default: "KimdisCode")code string nullablename string nullableprocedure_type object nullable@type string (default: "KimdisCode")code string nullablename string nullableaward_procedure object nullable@type string (default: "KimdisCode")code string nullablename string nullableaward_criterion object nullable@type string (default: "KimdisCode")code string nullablename string nullablesection_count integer nullablecontract_duration integer nullablecontract_duration_unit object nullable@type string (default: "KimdisCode")code string nullablename string nullablepublished_date string nullablesubmission_deadline_at integer nullableproceedings object nullable@type string (default: "KimdisCode")code string nullablename string nullabledigital_platform object nullable@type string (default: "KimdisCode")code string nullablename string nullablebidding_url string nullablesystem_numbers array (default: [])contracting_authorities array (default: [])@type string (default: "KimdisCode")code string nullablename string nullablemax_contractor_count integer nullableoffers_valid_time integer nullableoffers_valid_time_unit object nullable@type string (default: "KimdisCode")code string nullablename string nullablehas_option_right boolean nullableoption_right_description string nullableabort_reason object nullable@type string (default: "KimdisCode")code string nullablename string nullableis_amendment boolean nullableamended_notice_id string nullableamended_by_notice_ids array (default: [])related_notice_id string nullableapproved_request_ids array (default: [])award_ids array (default: [])422 — A date is not YYYY-MM-DD, a range is inverted, a code is not numeric, or the registry rejected the criteria Check the fields against this schema. A URN with the wrong prefix is the most common cause.408 — The request ran past its time limit Raise `timeout` in the request body, up to the maximum this endpoint documents. Lowering `count` or turning off the `with_*` flags also helps, because less work finishes sooner.412 — The entity was not found, or a precondition failed Retrying will not help: either the entity does not exist, or the input points at a different one.429 — Too many requests: a rate limit or a usage window is exhausted When the response carries an X-Retry-After header, wait that many seconds and retry: the same number is in the body as `detail.retry_after`, and the limit clears once that window passes. The message in the body names the limit that was hit.500 — Something broke on our side Retrying will not help. If it keeps happening, send us the X-Request-ID from the response headers.529 — Rate limit reached, or the endpoint is overloaded Wait at least 30 seconds, then retry.X-Error — Error message text (present only on error)X-Request-ID — Unique request identifierX-Execution-Time — Execution time in secondsX-Result-Count — How many records the body carries. 0 means an empty result, which is a normal answer and not by itself an error. A non-zero count can come back together with X-Error when the failure happened partway through — read this header and X-Error independently.X-Total-Available-Results — How many records exist for this query, when the endpoint can say. On a `dry_run` request this is the answer and the body is empty. It saturates: the endpoint's documented maximum means 'at least that many', any smaller number is exact.X-Warning — Present when the request body carried keys this endpoint does not document. They were ignored, so any filter you meant to apply through them did not apply. Check the spelling against this schema and retry.X-Retry-After — Seconds to wait before retrying. Present only on 429.