/tenderned/tenders

POST /api/tenderned/tenders

Price: 10 credits

Get one TenderNed publication by its id or page URL with its whole notice body: title, description, notice type, stage and status, buyer with legal type and activity, legal framework, procedure, every lot with place of performance, duration, value, award criteria and deadlines, results with winners, contracts and received-tender counts, every organisation with registration number, address, contact and roles, CPV and NUTS codes, the TED reference and the third-party platform the procedure runs on.

How to use it

Pass the id of a tenderned/tenders/search row such as 440853. layout tells which form the notice was filed on (notice_code EFxx is eforms, SFxx the legacy TED form): eforms notices carry procedure, lots, results and organisations in full, legacy notices carry the buyer, lots, winners and values the old form states and the rest as sections. suppliers holds the organisations that won a lot.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• tender union required — Publication id or page URL (examples: 440877, "440853", "https://www.tenderned.nl/aankondigingen/overzicht/440877")

Response

• @type string (default: "TendernedTender")
• id string required
• procedure_id string nullable
• description string nullable
• buyer object nullable
  • @type string (default: "TendernedOrganisation")
  • id string nullable
  • name string nullable
  • registration_number string nullable
  • department string nullable
  • size string nullable
  • address string nullable
  • city string nullable
  • postcode string nullable
  • region string nullable
  • region_code string nullable
  • country string nullable
  • contact_name string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • url string nullable
  • roles array (default: [])
  • won_lots array (default: [])
• buyer_legal_type string nullable
• buyer_activity string nullable
• notice_type object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• notice_code object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• stage string nullable
• status object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• legal_framework object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• scope object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• contract_type object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• contract_nature object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• procedure object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• digital_submission object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• is_digital_submission_possible boolean nullable
• is_awarded boolean nullable
• is_completed boolean nullable
• is_imported boolean nullable
• is_early_terminated boolean nullable
• is_award_only boolean nullable
• ted_number string nullable
• reference_number string nullable
• keywords array (default: [])
• last_rectification_id string nullable
• early_termination_id string nullable
• deviating_regulation string nullable
• duration object nullable
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• suppliers array (default: [])
  • @type string (default: "TendernedOrganisation")
  • id string nullable
  • name string nullable
  • registration_number string nullable
  • department string nullable
  • size string nullable
  • address string nullable
  • city string nullable
  • postcode string nullable
  • region string nullable
  • region_code string nullable
  • country string nullable
  • contact_name string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • url string nullable
  • roles array (default: [])
  • won_lots array (default: [])
• value object nullable
  • @type string (default: "TendernedValue")
  • amount number nullable
  • currency string nullable
  • text string nullable
• dates object nullable
  • @type string (default: "TendernedDates")
  • published string nullable
  • published_at integer nullable
  • deadline_at integer nullable
  • days_to_deadline integer nullable
  • market_consultation_deadline_at integer nullable
  • contract_start string nullable
  • contract_end string nullable
• cpv array (default: [])
  • @type string (default: "TendernedCpv")
  • code string required
  • label string nullable
  • is_main boolean (default: false)
• nuts array (default: [])
  • @type string (default: "TendernedCode")
  • code string nullable
  • label string nullable
• platform object nullable
  • @type string (default: "TendernedPlatform")
  • name string nullable
  • url string nullable
• layout string required
• procedure_info object nullable
  • @type string (default: "TendernedProcedure-Output")
  • description string nullable
  • procedure_id string nullable
  • internal_id string nullable
  • procedure_type string nullable
  • main_features string nullable
  • contract_nature string nullable
  • main_classification string nullable
  • main_classification_code string nullable
  • additional_classifications array (default: [])
  • place object nullable
    • @type string (default: "TendernedPlace")
    • address string nullable
    • city string nullable
    • postcode string nullable
    • region string nullable
    • region_code string nullable
    • country string nullable
    • additional_information string nullable
  • estimated_value object nullable
    • @type string (default: "TendernedValue")
    • amount number nullable
    • currency string nullable
    • text string nullable
  • legal_basis string nullable
• lots array (default: [])
  • @type string (default: "TendernedLot")
  • id string nullable
  • description string nullable
  • internal_id string nullable
  • contract_nature string nullable
  • main_classification string nullable
  • main_classification_code string nullable
  • additional_classifications array (default: [])
  • place object nullable
    • @type string (default: "TendernedPlace")
    • address string nullable
    • city string nullable
    • postcode string nullable
    • region string nullable
    • region_code string nullable
    • country string nullable
    • additional_information string nullable
  • start_date string nullable
  • end_date string nullable
  • duration string nullable
  • renewal_max string nullable
  • renewal_description string nullable
  • options_description string nullable
  • estimated_value object nullable
    • @type string (default: "TendernedValue")
    • amount number nullable
    • currency string nullable
    • text string nullable
  • framework_max_value object nullable
    • @type string (default: "TendernedValue")
    • amount number nullable
    • currency string nullable
    • text string nullable
  • award_criteria array (default: [])
    • @type string (default: "TendernedAwardCriterion")
    • kind string nullable
    • name string nullable
    • description string nullable
    • weight_kind string nullable
    • weight string nullable
  • deadline string nullable
  • requests_deadline string nullable
  • questions_deadline string nullable
  • validity_deadline string nullable
  • documents_url string nullable
  • submission_url string nullable
  • review_organisation string nullable
  • contract_signer string nullable
• results array (default: [])
  • @type string (default: "TendernedResult")
  • lot_id string nullable
  • framework_max_value object nullable
    • @type string (default: "TendernedValue")
    • amount number nullable
    • currency string nullable
    • text string nullable
  • winners array (default: [])
    • @type string (default: "TendernedWinner")
    • name string nullable
    • registration_number string nullable
    • city string nullable
    • region string nullable
    • country string nullable
    • tender_id string nullable
    • lot_id string nullable
    • tender_value object nullable (see schema TendernedValue)
    • subcontracting string nullable
    • contract_id string nullable
    • contract_title string nullable
    • award_date string nullable
    • signature_date string nullable
    • contract_signer string nullable
  • received_tenders array (default: [])
    • @type string (default: "TendernedReceivedTenders")
    • kind string nullable
    • count integer nullable
  • value object nullable
    • @type string (default: "TendernedValue")
    • amount number nullable
    • currency string nullable
    • text string nullable
• organisations array (default: [])
  • @type string (default: "TendernedOrganisation")
  • id string nullable
  • name string nullable
  • registration_number string nullable
  • department string nullable
  • size string nullable
  • address string nullable
  • city string nullable
  • postcode string nullable
  • region string nullable
  • region_code string nullable
  • country string nullable
  • contact_name string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • url string nullable
  • roles array (default: [])
  • won_lots array (default: [])
• change object nullable
  • @type string (default: "TendernedChange")
  • previous_notice string nullable
  • modified_contract string nullable
  • reason string nullable
  • description string nullable
• notice_info object nullable
  • @type string (default: "TendernedNoticeInfo")
  • notice_version string nullable
  • form_type string nullable
  • notice_type string nullable
  • dispatch_date string nullable
  • languages string nullable
• sections array (default: [])
  • @type string (default: "TendernedSection")
  • number string nullable
  • fields array (default: [])
    • @type string (default: "TendernedField")
    • label string nullable
    • value string nullable
    • code string nullable
  • sections array (default: [])
• pdf_url string nullable
• country string (default: "NL")
• 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 publication with this identifier on TenderNed 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.