/oeffentlichevergabe/tenders

POST /api/oeffentlichevergabe/tenders

Price: 20 credits

Get one oeffentlichevergabe.de notice by its id or URL: title, description, notice type and stage, legal basis and German procurement regulation, procedure, estimated, awarded and framework agreement values, every organisation with roles, address, contact and identifiers, each lot with CPV codes, places, duration, deadlines, documents and award criteria, and for award notices the lot results with the reason a lot was not awarded, tenders, contracts and winning suppliers.

How to use it

Pass the id of an oeffentlichevergabe/tenders/search row, a UUID for eForms notices or a number for notices from service.bund.de. suppliers holds the winning organisations; tenders and contracts link each lot result to the supplier and the contract through their ids.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• tender string required — Notice id or notice URL (examples: "e2c93e8d-0b92-45eb-92c8-26ba761a7644", "25850686", "https://oeffentlichevergabe.de/ui/de/search/details?noticeId=25850686"; minLength: 1)

Response

• @type string (default: "OeffentlichevergabeTenderDetail")
• id string required
• version string nullable
• original_notice_id string nullable
• procedure_id string nullable
• internal_id string nullable
• description string nullable
• notice_type string nullable
• notice_subtype string nullable
• notice_kind string nullable
• stage string nullable
• legal_basis string nullable
• german_legal_basis string nullable
• german_legal_basis_description string nullable
• local_legal_bases array (default: [])
• procedure_type string nullable
• procedure_features string nullable
• cross_border_law string nullable
• is_accelerated boolean nullable
• direct_award_justification string nullable
• direct_award_justification_text string nullable
• lots_max_allowed integer nullable
• lots_max_awarded integer nullable
• is_all_lots_required boolean nullable
• contract_nature string nullable
• additional_natures array (default: [])
• cpv string nullable
• cpv_additional array (default: [])
• value object nullable
  • @type string (default: "OeffentlichevergabeValue")
  • amount number nullable
  • currency string nullable
• awarded_value object nullable
  • @type string (default: "OeffentlichevergabeValue")
  • amount number nullable
  • currency string nullable
• framework_value object nullable
  • @type string (default: "OeffentlichevergabeValue")
  • amount number nullable
  • currency string nullable
• buyer object nullable
  • @type string (default: "OeffentlichevergabeOrganisation")
  • id string nullable
  • name string nullable
  • department string nullable
  • identifiers array (default: [])
  • street string nullable
  • street_additional string nullable
  • city string nullable
  • postcode string nullable
  • nuts string nullable
  • country string nullable
  • contact_name string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • website_url string nullable
  • roles array (default: [])
  • sub_roles array (default: [])
  • legal_type string nullable
  • activity string nullable
  • contracting_entity_type string nullable
  • buyer_profile_url string nullable
  • is_awarding_cpb boolean nullable
  • is_acquiring_cpb boolean nullable
  • is_group_lead boolean nullable
  • service_provider_id string nullable
  • ted_sender_id string nullable
  • size string nullable
  • is_listed_on_regulated_market boolean nullable
  • beneficial_owner_ids array (default: [])
• buyers array (default: [])
  • @type string (default: "OeffentlichevergabeOrganisation")
  • id string nullable
  • name string nullable
  • department string nullable
  • identifiers array (default: [])
  • street string nullable
  • street_additional string nullable
  • city string nullable
  • postcode string nullable
  • nuts string nullable
  • country string nullable
  • contact_name string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • website_url string nullable
  • roles array (default: [])
  • sub_roles array (default: [])
  • legal_type string nullable
  • activity string nullable
  • contracting_entity_type string nullable
  • buyer_profile_url string nullable
  • is_awarding_cpb boolean nullable
  • is_acquiring_cpb boolean nullable
  • is_group_lead boolean nullable
  • service_provider_id string nullable
  • ted_sender_id string nullable
  • size string nullable
  • is_listed_on_regulated_market boolean nullable
  • beneficial_owner_ids array (default: [])
• suppliers array (default: [])
  • @type string (default: "OeffentlichevergabeOrganisation")
  • id string nullable
  • name string nullable
  • department string nullable
  • identifiers array (default: [])
  • street string nullable
  • street_additional string nullable
  • city string nullable
  • postcode string nullable
  • nuts string nullable
  • country string nullable
  • contact_name string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • website_url string nullable
  • roles array (default: [])
  • sub_roles array (default: [])
  • legal_type string nullable
  • activity string nullable
  • contracting_entity_type string nullable
  • buyer_profile_url string nullable
  • is_awarding_cpb boolean nullable
  • is_acquiring_cpb boolean nullable
  • is_group_lead boolean nullable
  • service_provider_id string nullable
  • ted_sender_id string nullable
  • size string nullable
  • is_listed_on_regulated_market boolean nullable
  • beneficial_owner_ids array (default: [])
• organisations array (default: [])
  • @type string (default: "OeffentlichevergabeOrganisation")
  • id string nullable
  • name string nullable
  • department string nullable
  • identifiers array (default: [])
  • street string nullable
  • street_additional string nullable
  • city string nullable
  • postcode string nullable
  • nuts string nullable
  • country string nullable
  • contact_name string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
  • website_url string nullable
  • roles array (default: [])
  • sub_roles array (default: [])
  • legal_type string nullable
  • activity string nullable
  • contracting_entity_type string nullable
  • buyer_profile_url string nullable
  • is_awarding_cpb boolean nullable
  • is_acquiring_cpb boolean nullable
  • is_group_lead boolean nullable
  • service_provider_id string nullable
  • ted_sender_id string nullable
  • size string nullable
  • is_listed_on_regulated_market boolean nullable
  • beneficial_owner_ids array (default: [])
• beneficial_owners array (default: [])
  • @type string (default: "OeffentlichevergabeBeneficialOwner")
  • id string nullable
  • name string nullable
  • nationalities array (default: [])
  • street string nullable
  • city string nullable
  • postcode string nullable
  • nuts string nullable
  • country string nullable
  • email string nullable
  • phone string nullable
  • fax string nullable
• places array (default: [])
  • @type string (default: "OeffentlichevergabePlace")
  • street string nullable
  • street_additional string nullable
  • city string nullable
  • postcode string nullable
  • nuts string nullable
  • country string nullable
  • other string nullable
  • additional_information string nullable
• lots array (default: [])
  • @type string (default: "OeffentlichevergabeLot")
  • id string nullable
  • description string nullable
  • internal_id string nullable
  • contract_nature string nullable
  • additional_natures array (default: [])
  • cpv string nullable
  • cpv_additional array (default: [])
  • quantity number nullable
  • quantity_unit string nullable
  • options_description string nullable
  • is_recurrent boolean nullable
  • recurrence_description string nullable
  • value object nullable
    • @type string (default: "OeffentlichevergabeValue")
    • amount number nullable
    • currency string nullable
  • framework_max_value object nullable
    • @type string (default: "OeffentlichevergabeValue")
    • amount number nullable
    • currency string nullable
  • places array (default: [])
    • @type string (default: "OeffentlichevergabePlace")
    • street string nullable
    • street_additional string nullable
    • city string nullable
    • postcode string nullable
    • nuts string nullable
    • country string nullable
    • other string nullable
    • additional_information string nullable
  • start_date string nullable
  • end_date string nullable
  • duration number nullable
  • duration_unit string nullable
  • duration_other string nullable
  • renewal_max integer nullable
  • renewal_description string nullable
  • deadline_at integer nullable
  • requests_deadline_at integer nullable
  • expressions_deadline_at integer nullable
  • answers_deadline_at integer nullable
  • information_deadline_at integer nullable
  • public_opening_at integer nullable
  • invitation_dispatch_date string nullable
  • interest_invitation_dispatch_date string nullable
  • submission_url string nullable
  • submission_electronic string nullable
  • submission_nonelectronic_justification string nullable
  • submission_nonelectronic_description string nullable
  • submission_languages array (default: [])
  • electronic_signature string nullable
  • electronic_catalogue string nullable
  • variants string nullable
  • is_multiple_tenders_allowed boolean nullable
  • is_guarantee_required boolean nullable
  • guarantee_description string nullable
  • tender_validity number nullable
  • tender_validity_unit string nullable
  • late_information string nullable
  • late_information_description string nullable
  • documents array (default: [])
    • @type string (default: "OeffentlichevergabeDocument")
    • id string nullable
    • url string nullable
    • restricted_url string nullable
    • is_restricted boolean nullable
    • restricted_justification string nullable
    • languages array (default: [])
    • non_official_languages array (default: [])
  • award_criteria array (default: [])
    • @type string (default: "OeffentlichevergabeAwardCriterion")
    • criterion_type string nullable
    • name string nullable
    • description string nullable
    • weight number nullable
    • weight_kind string nullable
  • award_criteria_method string nullable
  • award_criteria_order_justification string nullable
  • selection_criteria array (default: [])
    • @type string (default: "OeffentlichevergabeSelectionCriterion")
    • criterion_type string nullable
    • description string nullable
    • usage string nullable
    • is_second_stage_invite boolean nullable
    • second_stage_invites array (default: [])
  • selection_criteria_sources array (default: [])
  • framework_agreement string nullable
  • dynamic_purchasing_system string nullable
  • has_electronic_auction boolean nullable
  • has_framework_max_participants boolean nullable
  • framework_max_participants integer nullable
  • has_successive_reduction boolean nullable
  • min_candidates integer nullable
  • max_candidates integer nullable
  • has_max_candidates boolean nullable
  • eu_funds string nullable
  • eu_funds_details array (default: [])
    • @type string (default: "OeffentlichevergabeEuFunds")
    • financing_id string nullable
    • programme string nullable
  • previous_planning_ids array (default: [])
  • is_suitable_for_smes boolean nullable
  • suitable_for array (default: [])
  • has_gpa_coverage boolean nullable
  • is_relaunch boolean nullable
  • additional_information string nullable
  • strategic_procurement array (default: [])
  • strategic_procurement_description string nullable
  • green_procurement string nullable
  • social_procurement array (default: [])
  • has_innovation_measures boolean nullable
  • innovative_procurement string nullable
  • accessibility string nullable
  • is_clean_vehicles_directive boolean nullable
  • clean_vehicles_contract_type string nullable
  • is_energy_efficiency_directive boolean nullable
  • reserved_participation string nullable
  • reserved_execution string nullable
  • staff_qualification string nullable
  • has_security_clearance boolean nullable
  • security_clearance_description string nullable
  • has_non_disclosure_agreement boolean nullable
  • non_disclosure_agreement_description string nullable
  • has_foreign_subsidies_regulation boolean nullable
  • electronic_invoicing string nullable
  • has_electronic_ordering boolean nullable
  • has_electronic_payment boolean nullable
  • has_tenderer_legal_form boolean nullable
  • tenderer_legal_form_description string nullable
  • financial_terms string nullable
  • performance_terms string nullable
  • tool_name string nullable
  • tool_url string nullable
  • review_deadline_description string nullable
  • review_organisation_id string nullable
  • review_information_provider_id string nullable
  • mediator_id string nullable
  • information_provider_id string nullable
  • document_provider_id string nullable
  • tender_recipient_id string nullable
  • tender_evaluator_ids array (default: [])
• lot_results array (default: [])
  • @type string (default: "OeffentlichevergabeLotResult")
  • id string nullable
  • lot_id string nullable
  • winner_chosen string nullable
  • not_awarded_reason string nullable
  • framework_max_value object nullable
    • @type string (default: "OeffentlichevergabeValue")
    • amount number nullable
    • currency string nullable
  • received_submissions array (default: [])
    • @type string (default: "OeffentlichevergabeReceivedSubmissions")
    • submission_type string nullable
    • count integer nullable
  • tender_ids array (default: [])
  • contract_ids array (default: [])
  • financing_party_ids array (default: [])
  • payer_party_ids array (default: [])
  • clean_vehicles array (default: [])
    • @type string (default: "OeffentlichevergabeCleanVehicles")
    • contract_type string nullable
    • vehicles array (default: [])
• tenders array (default: [])
  • @type string (default: "OeffentlichevergabeTender")
  • id string nullable
  • lot_ids array (default: [])
  • value object nullable
    • @type string (default: "OeffentlichevergabeValue")
    • amount number nullable
    • currency string nullable
  • rank integer nullable
  • is_ranked boolean nullable
  • is_variant boolean nullable
  • subcontracting string nullable
  • references array (default: [])
  • tendering_party_id string nullable
  • supplier_names array (default: [])
• tendering_parties array (default: [])
  • @type string (default: "OeffentlichevergabeTenderingParty")
  • id string nullable
  • name string nullable
  • organisation_ids array (default: [])
  • group_lead_ids array (default: [])
• contracts array (default: [])
  • @type string (default: "OeffentlichevergabeContract")
  • id string nullable
  • identifier string nullable
  • conclusion_date string nullable
  • winner_decision_date string nullable
  • tender_ids array (default: [])
  • signatory_ids array (default: [])
  • modification object nullable
    • @type string (default: "OeffentlichevergabeChange")
    • changed_notice_id string nullable
    • reason string nullable
    • reason_description string nullable
    • sections array (default: [])
• change object nullable
  • @type string (default: "OeffentlichevergabeChange")
  • changed_notice_id string nullable
  • reason string nullable
  • reason_description string nullable
  • sections array (default: [])
    • @type string (default: "OeffentlichevergabeChangeItem")
    • section_id string nullable
    • description string nullable
• notice_references array (default: [])
  • @type string (default: "OeffentlichevergabeNoticeReference")
  • notice_id string nullable
  • lot_id string nullable
  • reference_type string nullable
• exclusion_grounds array (default: [])
  • @type string (default: "OeffentlichevergabeExclusionGround")
  • ground_type string nullable
  • description string nullable
• exclusion_grounds_sources array (default: [])
• additional_information array (default: [])
• languages array (default: [])
• dates object nullable
  • @type string (default: "OeffentlichevergabeDates")
  • published_at integer nullable
  • issued_at integer nullable
  • changed_at integer nullable
  • preferred_publication_date string nullable
  • future_notice_date string nullable
  • ted_published_date string nullable
  • ted_submitted_at integer nullable
  • deadline_at integer nullable
  • requests_deadline_at integer nullable
  • expressions_deadline_at integer nullable
  • answers_deadline_at integer nullable
• ted_publication_id string nullable
• eforms_version string nullable
• platform string nullable
• data_source string nullable
• is_relaunch boolean nullable
• country string (default: "DE")
• 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 notice with this identifier on oeffentlichevergabe.de 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.