/findatender/tenders

POST /api/findatender/tenders

Price: 55 credits

Get one Find a Tender procurement by its ocid, notice id or notice URL as its compiled OCDS record: title, description, status and stage, buyer and every party with identifiers, addresses and contacts, the tender terms with lots, items, CPV codes, periods and documents, awards with suppliers and values, contracts with amendments, bid statistics, related processes and the list of notices published for it.

How to use it

Pass the ocid from a search result or a notice id such as 089385-2026; a notice id resolves to its whole procurement, so the record covers every notice of that process, not only the one requested. Contracts Finder identifiers (ocds-b5fd17-...) are a different register and return 412 here.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• tender string required — Procurement identifier, notice id or notice URL (examples: "ocds-h6vhtk-077644", "089385-2026", "https://www.find-tender.service.gov.uk/procurement/ocds-h6vhtk-077644", "https://www.find-tender.service.gov.uk/Notice/089385-2026"; minLength: 1)

Response

• @type string (default: "FindatenderTender")
• id string required
• ocid string required
• description string nullable
• notice_description string nullable
• status string nullable
• stage string required
• tags array (default: [])
• buyer object nullable
  • @type string (default: "FindatenderPartyRef")
  • id string nullable
  • name string nullable
  • authority_type string nullable (one of: "central_government", "sub_central_government", "public_undertaking", "private_utility", "other")
• suppliers array (default: [])
  • @type string (default: "FindatenderPartyRef")
  • id string nullable
  • name string nullable
  • authority_type string nullable (one of: "central_government", "sub_central_government", "public_undertaking", "private_utility", "other")
• value object nullable
  • @type string (default: "FindatenderValue")
  • amount number nullable
  • amount_gross number nullable
  • currency string nullable
• dates object nullable
  • @type string (default: "FindatenderDates")
  • published_at integer nullable
  • deadline_at integer nullable
  • enquiry_deadline_at integer nullable
  • engagement_deadline_at integer nullable
  • future_notice_at integer nullable
  • awarded_at integer nullable
  • signed_at integer nullable
  • contract_start_at integer nullable
  • contract_end_at integer nullable
• cpv array (default: [])
  • @type string (default: "FindatenderClassification")
  • scheme string nullable
  • code string nullable
  • description string nullable
• country string (default: "GB")
• url string required
• language string nullable
• initiation_type string nullable
• parties array (default: [])
  • @type string (default: "FindatenderParty")
  • id string required
  • name string nullable
  • roles array (default: [])
  • role_details string nullable
  • identifier object nullable
    • @type string (default: "FindatenderIdentifier")
    • scheme string nullable
    • scheme_entered string nullable
    • id string nullable
    • legal_name string nullable
    • no_identifier_rationale string nullable
  • additional_identifiers array (default: [])
    • @type string (default: "FindatenderIdentifier")
    • scheme string nullable
    • scheme_entered string nullable
    • id string nullable
    • legal_name string nullable
    • no_identifier_rationale string nullable
  • address object nullable
    • @type string (default: "FindatenderAddress")
    • street string nullable
    • locality string nullable
    • region string nullable
    • postal_code string nullable
    • country string nullable
    • country_name string nullable
  • contact object nullable
    • @type string (default: "FindatenderContact")
    • name string nullable
    • email string nullable
    • telephone string nullable
    • fax string nullable
    • url string nullable
  • additional_contacts array (default: [])
    • @type string (default: "FindatenderContact")
    • name string nullable
    • email string nullable
    • telephone string nullable
    • fax string nullable
    • url string nullable
  • classifications array (default: [])
    • @type string (default: "FindatenderClassification")
    • scheme string nullable
    • code string nullable
    • description string nullable
  • authority_type string nullable (one of: "central_government", "sub_central_government", "public_undertaking", "private_utility", "other")
  • scale string nullable
  • is_vcse boolean nullable
  • is_public_service_mission_organization boolean nullable
  • is_sheltered_workshop boolean nullable
  • url string nullable
  • buyer_profile_url string nullable
  • control_description string nullable
• procurement object nullable
  • @type string (default: "FindatenderProcurement")
  • tender_id string nullable
  • procurement_method string nullable
  • procurement_method_details string nullable
  • procurement_method_rationale string nullable
  • procurement_method_rationale_classifications array (default: [])
    • @type string (default: "FindatenderClassification")
    • scheme string nullable
    • code string nullable
    • description string nullable
  • main_procurement_category string nullable
  • additional_procurement_categories array (default: [])
  • classification object nullable
    • @type string (default: "FindatenderClassification")
    • scheme string nullable
    • code string nullable
    • description string nullable
  • additional_classifications array (default: [])
    • @type string (default: "FindatenderClassification")
    • scheme string nullable
    • code string nullable
    • description string nullable
  • legal_basis object nullable
    • @type string (default: "FindatenderClassification")
    • scheme string nullable
    • code string nullable
    • description string nullable
  • legal_basis_url string nullable
  • is_above_threshold boolean nullable
  • is_competitive boolean nullable
  • is_accelerated boolean nullable
  • accelerated_rationale string nullable
  • procedure_features string nullable
  • special_regime array (default: [])
  • covered_by array (default: [])
  • submission_methods array (default: [])
  • submission_method_details string nullable
  • electronic_submission_policy string nullable
  • submission_languages array (default: [])
  • bid_validity object nullable
    • @type string (default: "FindatenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
    • max_extent_at integer nullable
    • duration_days integer nullable
  • tender_period object nullable
    • @type string (default: "FindatenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
    • max_extent_at integer nullable
    • duration_days integer nullable
  • enquiry_period object nullable
    • @type string (default: "FindatenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
    • max_extent_at integer nullable
    • duration_days integer nullable
  • award_period object nullable
    • @type string (default: "FindatenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
    • max_extent_at integer nullable
    • duration_days integer nullable
  • bid_opening_at integer nullable
  • bid_opening_description string nullable
  • bid_opening_address object nullable
    • @type string (default: "FindatenderAddress")
    • street string nullable
    • locality string nullable
    • region string nullable
    • postal_code string nullable
    • country string nullable
    • country_name string nullable
  • expression_of_interest_deadline_at integer nullable
  • future_notice_at integer nullable
  • atypical_tool_url string nullable
  • has_recurrence boolean nullable
  • recurrence_dates array (default: [])
  • recurrence_description string nullable
  • has_framework_agreement boolean nullable
  • framework_agreement object nullable
    • @type string (default: "FindatenderFrameworkAgreement")
    • agreement_type string nullable
    • method string nullable
    • description string nullable
    • period object nullable
      • @type string (default: "FindatenderPeriod")
      • start_at integer nullable
      • end_at integer nullable
      • max_extent_at integer nullable
      • duration_days integer nullable
    • period_rationale string nullable
    • buyer_categories string nullable
    • is_open_framework_scheme boolean nullable
    • maximum_participants number nullable
    • buyer_location_restrictions array (default: [])
  • has_dynamic_purchasing_system boolean nullable
  • dynamic_purchasing_system_status string nullable
  • has_electronic_auction boolean nullable
  • electronic_auction_description string nullable
  • maximum_lots_bid_per_supplier number nullable
  • maximum_lots_awarded_per_supplier number nullable
  • lots_award_criteria_details string nullable
  • no_lots_division_rationale string nullable
  • award_criteria_details string nullable
  • second_stage object nullable
    • @type string (default: "FindatenderSecondStage")
    • invitation_at integer nullable
    • minimum_candidates integer nullable
    • maximum_candidates integer nullable
    • has_successive_reduction boolean nullable
    • is_negotiation_unnecessary boolean nullable
  • design_contest object nullable
    • @type string (default: "FindatenderDesignContest")
    • has_prizes boolean nullable
    • prizes_description string nullable
    • rewards_details string nullable
    • has_follow_up_contracts boolean nullable
    • is_jury_decision_binding boolean nullable
    • jury_members array (default: [])
  • review_details string nullable
  • electronic_invoicing_policy string nullable
  • financial_terms string nullable
  • performance_terms string nullable
  • tenderer_legal_form string nullable
  • has_electronic_ordering boolean nullable
  • has_electronic_payment boolean nullable
  • requires_staff_names_and_qualifications boolean nullable
  • reduction_criteria string nullable
  • reserved_participation_location string nullable
  • reserved_participation_gazetteer array (default: [])
  • risk_details string nullable
  • selection_criteria array (default: [])
    • @type string (default: "FindatenderCriterion")
    • criterion_type string nullable
    • name string nullable
    • description string nullable
    • minimum string nullable
    • verification_method string nullable
    • is_for_reduction boolean nullable
    • number number nullable
    • weight string nullable
    • applies_to array (default: [])
  • participation_fees array (default: [])
    • @type string (default: "FindatenderParticipationFee")
    • id string nullable
    • types array (default: [])
    • description string nullable
    • proportion number nullable
    • monetary_value_basis string nullable
  • lots array (default: [])
    • @type string (default: "FindatenderLot")
    • id string required
    • description string nullable
    • status string nullable
    • value object nullable
      • @type string (default: "FindatenderValue")
      • amount number nullable
      • amount_gross number nullable
      • currency string nullable
    • contract_period object nullable
      • @type string (default: "FindatenderPeriod")
      • start_at integer nullable
      • end_at integer nullable
      • max_extent_at integer nullable
      • duration_days integer nullable
    • award_criteria array (default: [])
    • award_criteria_description string nullable
    • weighting_description string nullable
    • selection_criteria array (default: [])
    • selection_criteria_description string nullable
    • second_stage object nullable
      • @type string (default: "FindatenderSecondStage")
      • invitation_at integer nullable
      • minimum_candidates integer nullable
      • maximum_candidates integer nullable
      • has_successive_reduction boolean nullable
      • is_negotiation_unnecessary boolean nullable
    • has_options boolean nullable
    • options_description string nullable
    • has_renewal boolean nullable
    • renewal_description string nullable
    • is_sme_suitable boolean nullable
    • is_vcse_suitable boolean nullable
    • variant_policy string nullable
    • electronic_catalogue_policy string nullable
  • line_items array (default: [])
    • @type string (default: "FindatenderItem")
    • id string required
    • classification object nullable
      • @type string (default: "FindatenderClassification")
      • scheme string nullable
      • code string nullable
      • description string nullable
    • additional_classifications array (default: [])
    • delivery_addresses array (default: [])
    • delivery_location string nullable
    • related_lot string nullable
  • documents array (default: [])
    • @type string (default: "FindatenderDocument")
    • id string required
    • document_type string nullable
    • notice_type string nullable
    • description string nullable
    • url string nullable
    • media_type string nullable
    • published_at integer nullable
    • access_details string nullable
  • amendments array (default: [])
    • @type string (default: "FindatenderAmendment")
    • id string required
    • amended_at integer nullable
    • description string nullable
    • rationale string nullable
• planning object nullable
  • @type string (default: "FindatenderPlanning")
  • documents array (default: [])
    • @type string (default: "FindatenderDocument")
    • id string required
    • document_type string nullable
    • notice_type string nullable
    • description string nullable
    • url string nullable
    • media_type string nullable
    • published_at integer nullable
    • access_details string nullable
  • milestones array (default: [])
    • @type string (default: "FindatenderMilestone")
    • id string required
    • milestone_type string nullable
    • description string nullable
    • status string nullable
    • due_at integer nullable
  • no_engagement_notice_rationale string nullable
• awards array (default: [])
  • @type string (default: "FindatenderAward")
  • id string required
  • status string nullable
  • status_details string nullable
  • awarded_at integer nullable
  • value object nullable
    • @type string (default: "FindatenderValue")
    • amount number nullable
    • amount_gross number nullable
    • currency string nullable
  • suppliers array (default: [])
    • @type string (default: "FindatenderPartyRef")
    • id string nullable
    • name string nullable
    • authority_type object nullable (see schema FindatenderAuthorityType)
  • line_items array (default: [])
    • @type string (default: "FindatenderItem")
    • id string required
    • classification object nullable (see schema FindatenderClassification)
    • additional_classifications array (default: [])
    • delivery_addresses array (default: [])
    • delivery_location string nullable
    • related_lot string nullable
  • contract_period object nullable
    • @type string (default: "FindatenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
    • max_extent_at integer nullable
    • duration_days integer nullable
  • related_lots array (default: [])
  • documents array (default: [])
    • @type string (default: "FindatenderDocument")
    • id string required
    • document_type string nullable
    • notice_type string nullable
    • description string nullable
    • url string nullable
    • media_type string nullable
    • published_at integer nullable
    • access_details string nullable
  • milestones array (default: [])
    • @type string (default: "FindatenderMilestone")
    • id string required
    • milestone_type string nullable
    • description string nullable
    • status string nullable
    • due_at integer nullable
  • amendments array (default: [])
    • @type string (default: "FindatenderAmendment")
    • id string required
    • amended_at integer nullable
    • description string nullable
    • rationale string nullable
  • main_procurement_category string nullable
  • is_above_threshold boolean nullable
  • has_options boolean nullable
  • options_description string nullable
  • has_renewal boolean nullable
  • renewal_description string nullable
  • has_subcontracting boolean nullable
  • subcontracting object nullable
    • @type string (default: "FindatenderSubcontracting")
    • description string nullable
    • value object nullable
      • @type string (default: "FindatenderValue")
      • amount number nullable
      • amount_gross number nullable
      • currency string nullable
    • minimum_percentage number nullable
    • maximum_percentage number nullable
  • standstill_end_at integer nullable
  • assessment_summaries_sent_at integer nullable
  • final_status_at integer nullable
• contracts array (default: [])
  • @type string (default: "FindatenderContract")
  • id string required
  • award_id string nullable
  • status string nullable
  • status_details string nullable
  • value object nullable
    • @type string (default: "FindatenderValue")
    • amount number nullable
    • amount_gross number nullable
    • currency string nullable
  • signed_at integer nullable
  • period object nullable
    • @type string (default: "FindatenderPeriod")
    • start_at integer nullable
    • end_at integer nullable
    • max_extent_at integer nullable
    • duration_days integer nullable
  • line_items array (default: [])
    • @type string (default: "FindatenderItem")
    • id string required
    • classification object nullable (see schema FindatenderClassification)
    • additional_classifications array (default: [])
    • delivery_addresses array (default: [])
    • delivery_location string nullable
    • related_lot string nullable
  • documents array (default: [])
    • @type string (default: "FindatenderDocument")
    • id string required
    • document_type string nullable
    • notice_type string nullable
    • description string nullable
    • url string nullable
    • media_type string nullable
    • published_at integer nullable
    • access_details string nullable
  • amendments array (default: [])
    • @type string (default: "FindatenderAmendment")
    • id string required
    • amended_at integer nullable
    • description string nullable
    • rationale string nullable
  • is_above_threshold boolean nullable
  • has_renewal boolean nullable
  • renewal_description string nullable
  • agreed_metrics array (default: [])
    • @type string (default: "FindatenderAgreedMetric")
    • id string nullable
    • description string nullable
    • observations array (default: [])
  • no_agreed_metrics_rationale string nullable
• bid_statistics array (default: [])
  • @type string (default: "FindatenderBidStatistic")
  • id string nullable
  • measure string nullable
  • value number nullable
  • currency string nullable
  • related_lot string nullable
• bids array (default: [])
  • @type string (default: "FindatenderBid")
  • id string nullable
  • status string nullable
  • tenderers array (default: [])
    • @type string (default: "FindatenderPartyRef")
    • id string nullable
    • name string nullable
    • authority_type object nullable (see schema FindatenderAuthorityType)
  • related_lots array (default: [])
• related_processes array (default: [])
  • @type string (default: "FindatenderRelatedProcess")
  • id string nullable
  • relationships array (default: [])
  • scheme string nullable
  • identifier string nullable
  • related_lots array (default: [])
  • url string nullable
• links array (default: [])
  • @type string (default: "FindatenderLink")
  • rel string nullable
  • url string nullable
• notices array (default: [])
  • @type string (default: "FindatenderNotice")
  • id string required
  • tags array (default: [])
  • published_at integer nullable
  • url string required

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 or notice with this identifier on Find a Tender 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.