/mtender/tenders

POST /api/mtender/tenders

Price: 20 credits

Get one MTender procurement by its ocid or page URL as one merged OCDS record across its planning, evaluation and contract stages: title, description, status and stage, the buyer with IDNO, address, contact and activity codes, budget and estimated value, periods, lots and line items with CPV codes, documents, enquiries and answers, amendments, qualification criteria, electronic auctions, bids with tenderers and prices, pre-qualification submissions and qualification decisions, awards with suppliers, contracts with their agreed terms, every party and the list of stage records.

How to use it

Pass the ocid from a search result or the tender page URL; a stage ocid ending in -PN-, -AP-, -EV-, -NP-, -TP-, -FE- or -AC- resolves to its parent procurement. A budget ocid from the same register is not a tender and returns 412.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• tender string required — Tender ocid, stage ocid or tender page URL (examples: "ocds-b3wdp1-MD-1769073273769", "ocds-b3wdp1-MD-1769073273769-EV-1769073490153", "https://mtender.gov.md/tenders/ocds-b3wdp1-MD-1769073273769"; minLength: 1)

Response

• @type string (default: "MtenderTender")
• id string required
• ocid string required
• description string nullable
• status string nullable
• status_details string nullable
• process_status_details string nullable
• stage string required
• procedure_type string nullable
• procurement_method string nullable
• procurement_method_rationale string nullable
• main_procurement_category string nullable
• legal_basis string nullable
• award_criteria string nullable
• award_criteria_details string nullable
• eligibility_criteria string nullable
• submission_methods array (default: [])
• submission_method_details string nullable
• procurement_method_modalities array (default: [])
• buyer object nullable
  • @type string (default: "MtenderParty")
  • id string required
  • name string nullable
  • roles array (default: [])
  • identifier object nullable
    • @type string (default: "MtenderIdentifier")
    • scheme string nullable
    • id string nullable
    • legal_name string nullable
    • url string nullable
  • address object nullable
    • @type string (default: "MtenderAddress")
    • street string nullable
    • postal_code string nullable
    • locality string nullable
    • locality_code string nullable
    • region string nullable
    • region_code string nullable
    • country string nullable
    • country_name string nullable
  • contact object nullable
    • @type string (default: "MtenderContact")
    • name string nullable
    • email string nullable
    • telephone string nullable
    • fax string nullable
    • url string nullable
  • buyer_type string nullable
  • main_general_activity string nullable
  • main_sectoral_activity string nullable
  • supplier_type string nullable
  • scale string nullable
  • main_economic_activities array (default: [])
    • @type string (default: "MtenderClassification")
    • scheme string nullable
    • code string required
    • description string nullable
  • persons array (default: [])
    • @type string (default: "MtenderPerson")
    • id string nullable
    • name string nullable
    • identifier object nullable
      • @type string (default: "MtenderIdentifier")
      • scheme string nullable
      • id string nullable
      • legal_name string nullable
      • url string nullable
    • business_functions array (default: [])
• suppliers array (default: [])
  • @type string (default: "MtenderPartyRef")
  • id string nullable
  • name string nullable
• value object nullable
  • @type string (default: "MtenderValue")
  • amount number nullable
  • amount_net number nullable
  • currency string nullable
• dates object nullable
  • @type string (default: "MtenderDates")
  • published_at integer nullable
  • modified_at integer nullable
  • enquiry_deadline_at integer nullable
  • deadline_at integer nullable
  • auction_at integer nullable
  • awarded_at integer nullable
  • contract_at integer nullable
  • contract_start_at integer nullable
  • contract_end_at integer nullable
• cpv array (default: [])
  • @type string (default: "MtenderClassification")
  • scheme string nullable
  • code string required
  • description string nullable
• classification object nullable
  • @type string (default: "MtenderClassification")
  • scheme string nullable
  • code string required
  • description string nullable
• country string (default: "MD")
• url string required
• language string nullable
• initiation_type string nullable
• is_accelerated boolean nullable
• is_framework boolean nullable
• has_dynamic_purchasing_system boolean nullable
• is_joint_procurement boolean nullable
• is_procedure_outsourced boolean nullable
• is_design_contest_service_award boolean nullable
• uses_electronic_ordering boolean nullable
• uses_electronic_payment boolean nullable
• accepts_electronic_invoicing boolean nullable
• has_enquiries boolean nullable
• requires_electronic_catalogue boolean nullable
• reduction_criteria string nullable
• qualification_system_methods array (default: [])
• second_stage_min_candidates integer nullable
• second_stage_max_candidates integer nullable
• enquiry_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• tender_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• pre_qualification_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• qualification_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• auction_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• award_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• standstill_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• contract_period object nullable
  • @type string (default: "MtenderPeriod")
  • start_at integer nullable
  • end_at integer nullable
• planning object nullable
  • @type string (default: "MtenderPlanning")
  • budget object nullable
    • @type string (default: "MtenderValue")
    • amount number nullable
    • amount_net number nullable
    • currency string nullable
  • budget_description string nullable
  • is_eu_funded boolean nullable
  • budget_breakdown array (default: [])
    • @type string (default: "MtenderBudgetBreakdown")
    • id string nullable
    • description string nullable
    • amount object nullable
      • @type string (default: "MtenderValue")
      • amount number nullable
      • amount_net number nullable
      • currency string nullable
    • period object nullable
      • @type string (default: "MtenderPeriod")
      • start_at integer nullable
      • end_at integer nullable
    • source_party object nullable
      • @type string (default: "MtenderPartyRef")
      • id string nullable
      • name string nullable
• parties array (default: [])
  • @type string (default: "MtenderParty")
  • id string required
  • name string nullable
  • roles array (default: [])
  • identifier object nullable
    • @type string (default: "MtenderIdentifier")
    • scheme string nullable
    • id string nullable
    • legal_name string nullable
    • url string nullable
  • address object nullable
    • @type string (default: "MtenderAddress")
    • street string nullable
    • postal_code string nullable
    • locality string nullable
    • locality_code string nullable
    • region string nullable
    • region_code string nullable
    • country string nullable
    • country_name string nullable
  • contact object nullable
    • @type string (default: "MtenderContact")
    • name string nullable
    • email string nullable
    • telephone string nullable
    • fax string nullable
    • url string nullable
  • buyer_type string nullable
  • main_general_activity string nullable
  • main_sectoral_activity string nullable
  • supplier_type string nullable
  • scale string nullable
  • main_economic_activities array (default: [])
    • @type string (default: "MtenderClassification")
    • scheme string nullable
    • code string required
    • description string nullable
  • persons array (default: [])
    • @type string (default: "MtenderPerson")
    • id string nullable
    • name string nullable
    • identifier object nullable (see schema MtenderIdentifier)
    • business_functions array (default: [])
• line_items array (default: [])
  • @type string (default: "MtenderItem")
  • id string required
  • internal_id string nullable
  • description string nullable
  • classification object nullable
    • @type string (default: "MtenderClassification")
    • scheme string nullable
    • code string required
    • description string nullable
  • additional_classifications array (default: [])
    • @type string (default: "MtenderClassification")
    • scheme string nullable
    • code string required
    • description string nullable
  • quantity number nullable
  • unit object nullable
    • @type string (default: "MtenderUnit")
    • id string nullable
    • name string nullable
    • scheme string nullable
    • value object nullable
      • @type string (default: "MtenderValue")
      • amount number nullable
      • amount_net number nullable
      • currency string nullable
  • related_lot string nullable
• lots array (default: [])
  • @type string (default: "MtenderLot")
  • id string required
  • internal_id string nullable
  • description string nullable
  • status string nullable
  • status_details string nullable
  • value object nullable
    • @type string (default: "MtenderValue")
    • amount number nullable
    • amount_net number nullable
    • currency string nullable
  • contract_period object nullable
    • @type string (default: "MtenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
  • place_of_performance object nullable
    • @type string (default: "MtenderAddress")
    • street string nullable
    • postal_code string nullable
    • locality string nullable
    • locality_code string nullable
    • region string nullable
    • region_code string nullable
    • country string nullable
    • country_name string nullable
  • place_of_performance_description string nullable
  • has_options boolean nullable
  • has_recurrence boolean nullable
  • has_renewal boolean nullable
• documents array (default: [])
  • @type string (default: "MtenderDocument")
  • id string required
  • description string nullable
  • document_type string nullable
  • url string nullable
  • related_lots array (default: [])
  • published_at integer nullable
• enquiries array (default: [])
  • @type string (default: "MtenderEnquiry")
  • id string required
  • description string nullable
  • answer string nullable
  • related_lot string nullable
  • asked_at integer nullable
  • answered_at integer nullable
• amendments array (default: [])
  • @type string (default: "MtenderAmendment")
  • id string required
  • amendment_type string nullable
  • status string nullable
  • rationale string nullable
  • description string nullable
  • relates_to string nullable
  • related_item string nullable
  • release_id string nullable
  • amends_release_id string nullable
  • date_at integer nullable
  • documents array (default: [])
    • @type string (default: "MtenderDocument")
    • id string required
    • description string nullable
    • document_type string nullable
    • url string nullable
    • related_lots array (default: [])
    • published_at integer nullable
• criteria array (default: [])
  • @type string (default: "MtenderCriterion")
  • id string required
  • description string nullable
  • source string nullable
  • relates_to string nullable
  • related_item string nullable
  • classification object nullable
    • @type string (default: "MtenderClassification")
    • scheme string nullable
    • code string required
    • description string nullable
  • requirement_groups array (default: [])
    • @type string (default: "MtenderRequirementGroup")
    • id string required
    • description string nullable
    • requirements array (default: [])
• auctions array (default: [])
  • @type string (default: "MtenderAuction")
  • id string required
  • related_lot string nullable
  • period object nullable
    • @type string (default: "MtenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
  • url string nullable
  • minimum_step object nullable
    • @type string (default: "MtenderValue")
    • amount number nullable
    • amount_net number nullable
    • currency string nullable
  • results array (default: [])
    • @type string (default: "MtenderAuctionResult")
    • related_bid string nullable
    • value object nullable (see schema MtenderValue)
• bids array (default: [])
  • @type string (default: "MtenderBid")
  • id string required
  • status string nullable
  • status_details string nullable
  • tenderers array (default: [])
    • @type string (default: "MtenderPartyRef")
    • id string nullable
    • name string nullable
  • value object nullable
    • @type string (default: "MtenderValue")
    • amount number nullable
    • amount_net number nullable
    • currency string nullable
  • related_lots array (default: [])
  • date_at integer nullable
  • documents array (default: [])
    • @type string (default: "MtenderDocument")
    • id string required
    • description string nullable
    • document_type string nullable
    • url string nullable
    • related_lots array (default: [])
    • published_at integer nullable
• submissions array (default: [])
  • @type string (default: "MtenderSubmission")
  • id string required
  • status string nullable
  • candidates array (default: [])
    • @type string (default: "MtenderPartyRef")
    • id string nullable
    • name string nullable
  • date_at integer nullable
  • documents array (default: [])
    • @type string (default: "MtenderDocument")
    • id string required
    • description string nullable
    • document_type string nullable
    • url string nullable
    • related_lots array (default: [])
    • published_at integer nullable
• qualifications array (default: [])
  • @type string (default: "MtenderQualification")
  • id string required
  • status string nullable
  • status_details string nullable
  • description string nullable
  • related_submission string nullable
  • date_at integer nullable
  • documents array (default: [])
    • @type string (default: "MtenderDocument")
    • id string required
    • description string nullable
    • document_type string nullable
    • url string nullable
    • related_lots array (default: [])
    • published_at integer nullable
  • requirement_responses array (default: [])
    • @type string (default: "MtenderRequirementResponse")
    • id string required
    • requirement_id string nullable
    • value union nullable
    • related_tenderer_id string nullable
    • responder object nullable (see schema MtenderPartyRef)
• awards array (default: [])
  • @type string (default: "MtenderAward")
  • id string required
  • internal_id string nullable
  • status string nullable
  • status_details string nullable
  • description string nullable
  • suppliers array (default: [])
    • @type string (default: "MtenderPartyRef")
    • id string nullable
    • name string nullable
  • value object nullable
    • @type string (default: "MtenderValue")
    • amount number nullable
    • amount_net number nullable
    • currency string nullable
  • related_lots array (default: [])
  • related_bid string nullable
  • date_at integer nullable
  • line_items array (default: [])
    • @type string (default: "MtenderItem")
    • id string required
    • internal_id string nullable
    • description string nullable
    • classification object nullable (see schema MtenderClassification)
    • additional_classifications array (default: [])
    • quantity number nullable
    • unit object nullable (see schema MtenderUnit)
    • related_lot string nullable
  • documents array (default: [])
    • @type string (default: "MtenderDocument")
    • id string required
    • description string nullable
    • document_type string nullable
    • url string nullable
    • related_lots array (default: [])
    • published_at integer nullable
  • requirement_responses array (default: [])
    • @type string (default: "MtenderRequirementResponse")
    • id string required
    • requirement_id string nullable
    • value union nullable
    • related_tenderer_id string nullable
    • responder object nullable (see schema MtenderPartyRef)
• contracts array (default: [])
  • @type string (default: "MtenderContract")
  • id string required
  • award_id string nullable
  • status string nullable
  • status_details string nullable
  • related_lots array (default: [])
  • is_framework_or_dynamic boolean nullable
  • date_at integer nullable
  • agreed_metrics array (default: [])
    • @type string (default: "MtenderAgreedMetric")
    • id string nullable
    • description string nullable
    • observations array (default: [])
  • related_processes array (default: [])
    • @type string (default: "MtenderRelatedProcess")
    • id string nullable
    • identifier string nullable
    • relationships array (default: [])
    • scheme string nullable
    • url string nullable
• related_processes array (default: [])
  • @type string (default: "MtenderRelatedProcess")
  • id string nullable
  • identifier string nullable
  • relationships array (default: [])
  • scheme string nullable
  • url string nullable
• records array (default: [])
  • @type string (default: "MtenderRecord")
  • ocid string required
  • stage string required
  • tags array (default: [])
  • date_at 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 tender with this ocid on MTender 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.