/riigihanked/tenders

POST /api/riigihanked/tenders

Price: 10 credits

Get one procurement from the Estonian public procurement register by its id, register URL or reference number: name and description, state, procedure, contract type, sector, buyer and co-procurers with registry codes, CPV codes, estimated, contracted and actual value, key dates, every part with value, duration, CPV and place of performance, published notices with TED numbers, contracts with contractor, value, period and offer counts, and offer statistics.

How to use it

Pass the id of a riigihanked/tenders/search row as tender, or the six-digit reference number as reference_number, never both. suppliers lists the contractors of the procurement's contracts.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• tender string nullable — Procurement id or register URL (examples: "10845404", "https://riigihanked.riik.ee/rhr-web/#/procurement/10845404/general-info")
• reference_number string nullable — Procurement reference number (examples: "315814")

Response

• @type string (default: "RiigihankedTender")
• id string required
• reference_number string nullable
• description string nullable
• status string nullable
• stage string nullable
• contract_type string nullable
• procedure_type string nullable
• buyer object nullable
  • @type string (default: "RiigihankedOrganisation")
  • name string required
  • registry_code string nullable
  • country string nullable
  • role string nullable
• cpv_name string nullable
• dates object nullable
  • @type string (default: "RiigihankedTenderDates")
  • published_at integer nullable
  • deadline_at integer nullable
  • opening_at integer nullable
• notices_count integer nullable
• contracts_count integer nullable
• disputes_count integer nullable
• is_e_procurement boolean nullable
• is_multi_stage boolean nullable
• is_green boolean nullable
• is_suspended boolean nullable
• has_parts boolean nullable
• start_basis string nullable
• country string (default: "EE")
• url string required
• buyer_id string nullable
• organisers array (default: [])
  • @type string (default: "RiigihankedOrganisation")
  • name string required
  • registry_code string nullable
  • country string nullable
  • role string nullable
• suppliers array (default: [])
  • @type string (default: "RiigihankedOrganisation")
  • name string required
  • registry_code string nullable
  • country string nullable
  • role string nullable
• sector string nullable
• cpv array (default: [])
  • @type string (default: "RiigihankedCpv")
  • code string required
  • name string nullable
• value object nullable
  • @type string (default: "RiigihankedValue")
  • amount number nullable
  • currency string nullable
• contracted_value object nullable
  • @type string (default: "RiigihankedValue")
  • amount number nullable
  • currency string nullable
• actual_value object nullable
  • @type string (default: "RiigihankedValue")
  • amount number nullable
  • currency string nullable
• description_en string nullable
• responsible_person string nullable
• organization_reason string nullable
• procedure_justification string nullable
• ending_code string nullable
• additional_info string nullable
• additional_info_en string nullable
• additional_languages array (default: [])
• prior_procurement_id string nullable
• prior_procurement_reference_number string nullable
• prior_procurement_title string nullable
• procurement_plan_references array (default: [])
• duration_type string nullable
• duration_months integer nullable
• duration_days integer nullable
• is_divided_into_parts boolean nullable
• not_divided_reason string nullable
• no_electronic_offer_reason string nullable
• parts_count integer nullable
• parts_per_offer_max integer nullable
• max_contracts_per_tenderer integer nullable
• central_procurer_role string nullable
• central_purchasing_type string nullable
• is_dynamic_purchasing_system boolean nullable
• is_linked_to_dps boolean nullable
• is_linked_procurement boolean nullable
• is_without_notice boolean nullable
• is_classified boolean nullable
• is_electronic_ordering boolean nullable
• is_contract_signed_by_related_authority boolean nullable
• is_over_threshold boolean nullable
• is_eu_notice boolean nullable
• is_wto boolean nullable
• is_joint_procurement boolean nullable
• is_central_purchasing boolean nullable
• is_framework_single boolean nullable
• is_framework_multiple boolean nullable
• is_electronic_offer boolean nullable
• is_electronic_invoicing boolean nullable
• is_repeated boolean nullable
• documents_url string nullable
• uuid string nullable
• version_id string nullable
• parts array (default: [])
  • @type string (default: "RiigihankedPart")
  • number integer nullable
  • description string nullable
  • info string nullable
  • status string nullable
  • value object nullable
    • @type string (default: "RiigihankedValue")
    • amount number nullable
    • currency string nullable
  • duration_months integer nullable
  • duration_days integer nullable
  • ending_code string nullable
  • cpv array (default: [])
    • @type string (default: "RiigihankedCpv")
    • code string required
    • name string nullable
  • places array (default: [])
    • @type string (default: "RiigihankedPlace")
    • nuts string nullable
    • nuts_level3 array (default: [])
    • region string nullable
    • description string nullable
  • location string nullable
  • criterion_method string nullable
  • framework_agreement string nullable
  • framework_part_id string nullable
  • framework_part_number integer nullable
  • framework_part_title string nullable
  • participants_max_count integer nullable
  • questions_count integer nullable
  • renewal_description string nullable
  • renewal_limit integer nullable
  • environmental_approach string nullable
  • green_description string nullable
  • accessibility_justification string nullable
  • is_eu_funded boolean nullable
  • is_green boolean nullable
  • has_social_aspects boolean nullable
  • has_innovative_aspects boolean nullable
  • is_auction boolean nullable
  • is_electronic_catalogue boolean nullable
  • accepts_alternatives boolean nullable
  • is_renewable boolean nullable
  • has_options boolean nullable
  • accessibility string nullable
• notices array (default: [])
  • @type string (default: "RiigihankedNotice")
  • id string required
  • notice_type string nullable
  • category string nullable
  • state string nullable
  • submitted_at integer nullable
  • accepted_at integer nullable
  • published_at integer nullable
  • ted_number string nullable
  • ted_state string nullable
  • ted_sent_at integer nullable
  • ted_published_date string nullable
  • ted_url string nullable
  • previous_notice_id string nullable
  • previous_notice_category string nullable
• contracts array (default: [])
  • @type string (default: "RiigihankedContract")
  • id string required
  • number string nullable
  • order_number integer nullable
  • part_numbers string nullable
  • contract_ref string nullable
  • status string nullable
  • status_code string nullable
  • buyer object nullable
    • @type string (default: "RiigihankedOrganisation")
    • name string required
    • registry_code string nullable
    • country string nullable
    • role string nullable
  • supplier object nullable
    • @type string (default: "RiigihankedOrganisation")
    • name string required
    • registry_code string nullable
    • country string nullable
    • role string nullable
  • value object nullable
    • @type string (default: "RiigihankedValue")
    • amount number nullable
    • currency string nullable
  • actual_value object nullable
    • @type string (default: "RiigihankedValue")
    • amount number nullable
    • currency string nullable
  • start_date string nullable
  • end_date string nullable
  • actual_end_date string nullable
  • is_time_limited boolean nullable
  • is_framework boolean nullable
  • is_modified boolean nullable
  • framework_contract_id string nullable
  • call_off_number string nullable
  • offer_statistics object nullable
    • @type string (default: "RiigihankedOfferStatistics")
    • part_number integer nullable
    • offers_count integer nullable
    • electronic_offers_count integer nullable
    • sme_offers_count integer nullable
    • eu_offers_count integer nullable
    • non_eu_offers_count integer nullable
  • notice_ids array (default: [])
• offer_statistics array (default: [])
  • @type string (default: "RiigihankedOfferStatistics")
  • part_number integer nullable
  • offers_count integer nullable
  • electronic_offers_count integer nullable
  • sme_offers_count integer nullable
  • eu_offers_count integer nullable
  • non_eu_offers_count integer nullable

Errors

• 422 — The request body did not validate 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 — No procurement with this identifier in the Estonian procurement register 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.

Response headers

• X-Error — Error message text (present only on error)
• X-Request-ID — Unique request identifier
• X-Execution-Time — Execution time in seconds
• X-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.