/cejn/tenders

POST /api/cejn/tenders

Price: 20 credits

Get one CeJN tender by its id: contracting authority with address and contacts, procurement officer, procedure and contract type, CPV codes, estimated value, lots with their line items and quantities, the procurement plan lines it implements, eligibility conditions, award criteria, tender documents, phases with submission and opening dates, and the framework agreement a mini call-off is based on.

How to use it

Pass the id of a cejn/tenders/search row. Contracts concluded under the tender come from cejn/tenders/contracts with the same id.

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 id (examples: "122843")

Response

• @type string (default: "CejnTender")
• id string required
• notes string nullable
• status string nullable
• procedure_type string nullable
• contract_type string nullable
• cpvs array (default: [])
  • @type string (default: "CejnCpv")
  • code string nullable
  • name string nullable
• estimated_value object nullable
  • @type string (default: "CejnMoney")
  • amount number nullable
  • currency string nullable
• buyer object nullable
  • @type string (default: "CejnOrganizationRef")
  • id string nullable
  • name string nullable
  • short_name string nullable
  • tax_number string nullable
  • registration_number string nullable
  • address object nullable
    • @type string (default: "CejnAddress")
    • street string nullable
    • house_number string nullable
    • postcode string nullable
    • city_id string nullable
    • country_id string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • website string nullable
  • buyer_type string nullable
  • organization_form string nullable
  • activity_code string nullable
  • url string nullable
• contact_name string nullable
• procurement_officer object nullable
  • @type string (default: "CejnOfficer")
  • first_name string nullable
  • last_name string nullable
  • email string nullable
  • phone string nullable
  • position string nullable
  • has_certificate boolean nullable
• framework_agreement object nullable
  • @type string (default: "CejnFrameworkReference")
  • id string nullable
  • description string nullable
  • concluded_date string nullable
  • planned_value object nullable
    • @type string (default: "CejnMoney")
    • amount number nullable
    • currency string nullable
  • planned_vat object nullable
    • @type string (default: "CejnMoney")
    • amount number nullable
    • currency string nullable
• lots array (default: [])
  • @type string (default: "CejnLot")
  • id string nullable
  • number integer nullable
  • description string nullable
  • estimated_value object nullable
    • @type string (default: "CejnMoney")
    • amount number nullable
    • currency string nullable
  • is_contract_on_estimated_value boolean nullable
  • line_items array (default: [])
    • @type string (default: "CejnLotItem")
    • id string nullable
    • number integer nullable
    • description string nullable
    • characteristics string nullable
    • quantity number nullable
    • unit string nullable
• plan_lines array (default: [])
  • @type string (default: "CejnPlanLine")
  • id string nullable
  • plan_item_id string nullable
  • number integer nullable
  • description string nullable
  • plan_year integer nullable
  • cpvs array (default: [])
    • @type string (default: "CejnCpv")
    • code string nullable
    • name string nullable
  • procedure_type string nullable
  • subject_type string nullable
  • account_code string nullable
  • value object nullable
    • @type string (default: "CejnMoney")
    • amount number nullable
    • currency string nullable
  • vat object nullable
    • @type string (default: "CejnMoney")
    • amount number nullable
    • currency string nullable
  • is_framework_agreement boolean nullable
  • framework_agreement_id string nullable
  • framework_agreement_value object nullable
    • @type string (default: "CejnMoney")
    • amount number nullable
    • currency string nullable
  • framework_agreement_vat object nullable
    • @type string (default: "CejnMoney")
    • amount number nullable
    • currency string nullable
• eligibility_conditions array (default: [])
  • @type string (default: "CejnCondition")
  • id string nullable
  • description string nullable
  • condition_type string nullable
  • answer_type string nullable
  • scoring_method string nullable
  • applies_to_all_lots boolean nullable
  • is_ranking boolean nullable
  • max_score number nullable
• award_criteria array (default: [])
  • @type string (default: "CejnCondition")
  • id string nullable
  • description string nullable
  • condition_type string nullable
  • answer_type string nullable
  • scoring_method string nullable
  • applies_to_all_lots boolean nullable
  • is_ranking boolean nullable
  • max_score number nullable
• documents array (default: [])
  • @type string (default: "CejnDocument")
  • id string nullable
  • group string nullable
  • note string nullable
  • name string nullable
  • mime_type string nullable
  • size integer nullable
  • file_id string nullable
  • published_at integer nullable
• phases array (default: [])
  • @type string (default: "CejnPhase")
  • id string nullable
  • number integer nullable
  • description string nullable
  • phase_type string nullable
  • status string nullable
  • submissions_start_at integer nullable
  • submissions_end_at integer nullable
  • opening_at integer nullable
  • published_at integer nullable
• is_framework_agreement boolean nullable
• is_dynamic_purchasing_system boolean nullable
• is_electronic_auction boolean nullable
• is_electronic_catalogue boolean nullable
• is_joint_procurement boolean nullable
• is_centralised_procurement boolean nullable
• is_green_procurement boolean nullable
• is_socially_responsible boolean nullable
• has_phases boolean nullable
• created_at integer nullable
• published_at integer nullable
• updated_at integer nullable
• status_changed_at integer nullable
• url string 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 id in CeJN 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.