/eopbg/tenders

POST /api/eopbg/tenders

Price: 20 credits

Get one EOP tender by its id, national unique number or URL with everything the public register holds: title and description, status, procedure, buyer with EIK and contact, estimated value, CPV, key dates, lots, submission rounds and every received offer with bidder EIK and price, signed contracts with suppliers, values, periods and annexes, the full text of each published notice with its TED number, tender documents, announcements and appeal proceedings before the competition commission.

How to use it

Pass the id of an eopbg/tenders/search row, or the unique number such as 00160-2026-0020. suppliers lists the companies holding a signed contract; offers lists every bidder, including those that lost.

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, national unique number or tender URL (examples: "609466", "00160-2026-0020", "https://app.eop.bg/today/609466"; minLength: 1)

Response

• @type string (default: "EopbgTender")
• id string required
• special_number string nullable
• published_tender_id string nullable
• guid string nullable
• description string nullable
• status string nullable
• stage string nullable
• participation string nullable
• procedure_type string nullable
• contract_type string nullable
• technique string nullable
• award_criterion string nullable
• buyer object nullable
  • @type string (default: "EopbgBuyer")
  • id string nullable
  • name string required
  • registry_number string nullable
  • image string nullable
• value object nullable
  • @type string (default: "EopbgValue")
  • amount number nullable
  • amount_min number nullable
  • amount_max number nullable
  • currency string nullable
• cpv array (default: [])
• dates object nullable
  • @type string (default: "EopbgTenderDates")
  • published_at integer nullable
  • deadline_at integer nullable
  • offers_deadline_at integer nullable
  • offers_start_at integer nullable
  • opening_at integer nullable
  • price_opening_at integer nullable
  • status_changed_at integer nullable
• lots_count integer nullable
• offers_count integer nullable
• parent_tender_id string nullable
• parent_special_number string nullable
• child_tenders array (default: [])
• linked_tenders array (default: [])
• eu_programme_codes array (default: [])
• eu_programme_text string nullable
• appeal_urls array (default: [])
• flags object nullable
  • @type string (default: "EopbgFlags")
  • is_eco boolean nullable
  • is_social boolean nullable
  • is_innovative boolean nullable
  • is_strategic boolean nullable
  • is_joint_procurement boolean nullable
  • is_complained_about boolean nullable
  • has_preliminary_control boolean nullable
  • has_eu_programme boolean nullable
  • is_eu_funded boolean nullable
  • has_green_criteria boolean nullable
  • has_protected_jobs boolean nullable
  • has_strategic_requirements boolean nullable
  • is_security_and_defense boolean nullable
  • is_social_service boolean nullable
  • has_appeal_proceedings boolean nullable
• country string (default: "BG")
• url string required
• explicit_status string nullable
• is_framework_agreement boolean nullable
• has_separate_price_opening boolean nullable
• has_continuous_evaluation boolean nullable
• contact object nullable
  • @type string (default: "EopbgContact")
  • name string nullable
  • email string nullable
  • phone string nullable
• suppliers array (default: [])
  • @type string (default: "EopbgSupplier")
  • name string required
  • registry_number string nullable
• lots array (default: [])
  • @type string (default: "EopbgLot")
  • id string required
  • number integer nullable
  • status string nullable
  • status_changed_at integer nullable
• contracts array (default: [])
  • @type string (default: "EopbgContract")
  • id string required
  • lot_number integer nullable
  • lot_title string nullable
  • value object nullable
    • @type string (default: "EopbgValue")
    • amount number nullable
    • amount_min number nullable
    • amount_max number nullable
    • currency string nullable
  • current_value object nullable
    • @type string (default: "EopbgValue")
    • amount number nullable
    • amount_min number nullable
    • amount_max number nullable
    • currency string nullable
  • start_date string nullable
  • end_date string nullable
  • current_start_date string nullable
  • current_end_date string nullable
  • status_changed_at integer nullable
  • suppliers array (default: [])
    • @type string (default: "EopbgSupplier")
    • name string required
    • registry_number string nullable
  • annexes array (default: [])
    • @type string (default: "EopbgAnnex")
    • id string required
    • value object nullable (see schema EopbgValue)
    • start_date string nullable
    • end_date string nullable
    • status_changed_at integer nullable
    • suppliers array (default: [])
    • export_document_id string nullable
  • tender_id string nullable
  • export_document_id string nullable
• rounds array (default: [])
  • @type string (default: "EopbgRound")
  • name string nullable
  • number integer nullable
  • lot_title string nullable
  • opening_at integer nullable
  • price_opening_at integer nullable
  • has_separate_price_opening boolean nullable
  • offers_count integer (default: 0)
• offers array (default: [])
  • @type string (default: "EopbgOffer")
  • id string required
  • supplier object nullable
    • @type string (default: "EopbgSupplier")
    • name string required
    • registry_number string nullable
  • name string nullable
  • price number nullable
  • is_price_opened boolean nullable
  • submitted_at integer nullable
  • consortium_members array (default: [])
    • @type string (default: "EopbgSupplier")
    • name string required
    • registry_number string nullable
  • round string nullable
  • round_number integer nullable
  • lot_title string nullable
  • first_round_offer_id string nullable
  • hash string nullable
  • price_document_id string nullable
• notices array (default: [])
  • @type string (default: "EopbgNotice")
  • id string required
  • form_type string nullable
  • document_id string nullable
  • ted_number string nullable
  • parent_notice_id string nullable
  • is_signable boolean nullable
  • published_at integer nullable
  • text string nullable
• documents array (default: [])
  • @type string (default: "EopbgDocument")
  • id string required
  • name string nullable
  • extension string nullable
  • mime_type string nullable
  • size integer nullable
  • md5 string nullable
  • owner string nullable
  • created_at integer nullable
  • modified_at integer nullable
• announcements array (default: [])
  • @type string (default: "EopbgAnnouncement")
  • id string required
  • text string nullable
  • created_at integer nullable
• appeals array (default: [])
  • @type string (default: "EopbgAppeal")
  • proceedings_number string nullable
  • register_id string nullable
  • proceedings_type string nullable
  • status string nullable
  • subsections array (default: [])
  • initiators array (default: [])
  • defendants array (default: [])
  • has_interim_measures boolean nullable
  • started_at integer nullable
  • published_at integer nullable
  • closed_at integer nullable
  • last_decision_at integer nullable
  • legal_basis string nullable
  • url string nullable
• linked array (default: [])
  • @type string (default: "EopbgLinkedTender")
  • id string required
  • special_number string nullable
• children array (default: [])
  • @type string (default: "EopbgLinkedTender")
  • id string required
  • special_number string nullable
• parent object nullable
  • @type string (default: "EopbgLinkedTender")
  • id string required
  • special_number 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 record with this identifier on EOP 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.