/zakupkikg/tenders

POST /api/zakupkikg/tenders

Price: 20 credits

Kyrgyzstan public procurement tender from goszakupki.okmot.kg by id or URL: buyer, method, conditions and securities, lots with items and budget lines, qualification requirements, status history, bids with prices, evaluation ranking and signed contracts with payment and delivery schedules.

How to use it

Takes the 24-character `id` of a zakupkikg/tenders/search row; the 18-digit tender `number` is not accepted. `bids` stay empty until the bid-opening protocol is out and `contracts` until signature. A row without `published_at` answers 412.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• id string required — Tender id or tender URL (examples: "6aaa5a77d5978a4098c1a863", "https://goszakupki.okmot.kg/public/order/view/6aaa5a77d5978a4098c1a863"; minLength: 1)

Response

• @type string (default: "ZakupkikgTender")
• id string required
• number string nullable
• name string nullable
• url string required
• status string nullable
• method string nullable
• procurement_type string nullable
• buyer object nullable
  • @type string (default: "ZakupkikgCompanyRef")
  • id integer nullable
  • inn string nullable
  • name string nullable
• created_by string nullable
• total number nullable
• published_at integer nullable
• bid_deadline_at integer nullable
• bid_validity_days integer nullable
• is_bid_security_required boolean nullable
• bid_security_amount number nullable
• bid_security_unit string nullable
• bid_security_validity_days integer nullable
• bid_security_form string nullable
• performance_security_amount number nullable
• is_scored_evaluation boolean nullable
• is_central_purchase boolean nullable
• is_bsk boolean nullable
• allows_guarantee boolean nullable
• allows_insurance boolean nullable
• allows_other_currency boolean nullable
• allows_spares boolean nullable
• allows_technical_control boolean nullable
• dispute_resolution_court_type boolean nullable
• technical_control_title string nullable
• technical_control_place string nullable
• forfeit_day_rate_delivery number nullable
• forfeit_day_rate_payment number nullable
• forfeit_max_delivery number nullable
• forfeit_max_payment number nullable
• guarantee_forfeit_day_rate number nullable
• guarantee_max_deductible number nullable
• guarantee_period string nullable
• guarantee_defect_period string nullable
• packaging string nullable
• payment_advance_percent number nullable
• is_payment_advance boolean nullable
• payment_after_acceptance_percent number nullable
• is_payment_after_acceptance boolean nullable
• is_payment_after_shipment boolean nullable
• payment_maturity_at integer nullable
• related_service string nullable
• is_related_service boolean nullable
• spares string nullable
• single_source_reason string nullable
• single_source_reason_id integer nullable
• single_source_is_consultation boolean nullable
• single_source_note string nullable
• source_of_financing string nullable
• instruction_file object nullable
  • @type string (default: "ZakupkikgFile")
  • id string nullable
  • name string nullable
• project_file object nullable
  • @type string (default: "ZakupkikgFile")
  • id string nullable
  • name string nullable
• terms_of_reference_file object nullable
  • @type string (default: "ZakupkikgFile")
  • id string nullable
  • name string nullable
• required_documents array (default: [])
  • @type string (default: "ZakupkikgCode")
  • code string nullable
• evaluation_criteria array (default: [])
  • @type string (default: "ZakupkikgRequirement")
  • id integer nullable
  • template string nullable
  • is_required boolean nullable
  • score integer nullable
• qualification_requirements array (default: [])
  • @type string (default: "ZakupkikgRequirement")
  • id integer nullable
  • template string nullable
  • is_required boolean nullable
  • score integer nullable
• lots array (default: [])
  • @type string (default: "ZakupkikgLot")
  • id string nullable
  • number string nullable
  • name string nullable
  • amount number nullable
  • status string nullable
  • delivery_place string nullable
  • delivery_condition string nullable
  • delivery_period string nullable
  • nonresident_delivery_condition string nullable
  • incoterm string nullable
  • required_documents array (default: [])
    • @type string (default: "ZakupkikgCode")
    • code string nullable
  • file object nullable
    • @type string (default: "ZakupkikgFile")
    • id string nullable
    • name string nullable
  • budget_line object nullable
    • @type string (default: "ZakupkikgBudgetLine")
    • id integer nullable
    • account string nullable
    • account_id integer nullable
    • amount number nullable
    • year integer nullable
    • status string nullable
    • plan_type string nullable
    • confirmed_date string nullable
    • econ_classifier object nullable
      • @type string (default: "ZakupkikgClassifier")
      • id string nullable
      • name string nullable
      • parent_id string nullable
    • company_id integer nullable
    • company_name string nullable
  • products array (default: [])
    • @type string (default: "ZakupkikgProduct")
    • id string nullable
    • quantity number nullable
    • price number nullable
    • total number nullable
    • specifications string nullable
    • file object nullable (see schema ZakupkikgFile)
    • plan_line object nullable (see schema ZakupkikgPlanLine)
• history array (default: [])
  • @type string (default: "ZakupkikgHistoryEvent")
  • id string nullable
  • status string nullable
  • details string nullable
  • user_name string nullable
  • created_at integer nullable
• bids array (default: [])
  • @type string (default: "ZakupkikgBid")
  • id string nullable
  • status string nullable
  • supplier object nullable
    • @type string (default: "ZakupkikgCompanyRef")
    • id integer nullable
    • inn string nullable
    • name string nullable
  • created_by string nullable
  • submitted_at integer nullable
  • bid_security_amount number nullable
  • tech_amount number nullable
  • withdraw_stage string nullable
  • bid_validity_days integer nullable
  • confirmation_file object nullable
    • @type string (default: "ZakupkikgFile")
    • id string nullable
    • name string nullable
  • technical_proposal_file object nullable
    • @type string (default: "ZakupkikgFile")
    • id string nullable
    • name string nullable
  • bid_security object nullable
    • @type string (default: "ZakupkikgBidSecurity")
    • form string nullable
    • detail string nullable
    • amount number nullable
    • validity_days integer nullable
    • files array (default: [])
  • checks array (default: [])
    • @type string (default: "ZakupkikgBidCheck")
    • check_type string nullable
    • issuer string nullable
    • inn string nullable
    • has_debt boolean nullable
    • description string nullable
    • amount number nullable
    • checked_at integer nullable
    • result_code integer nullable
  • lots array (default: [])
    • @type string (default: "ZakupkikgBidLot")
    • lot_id string nullable
    • lot_number string nullable
    • lot_name string nullable
    • total_amount number nullable
    • discount_amount number nullable
    • delivery_condition string nullable
    • delivery_note string nullable
    • products array (default: [])
• evaluation array (default: [])
  • @type string (default: "ZakupkikgEvaluationRow")
  • id integer nullable
  • bid_id string nullable
  • supplier object nullable
    • @type string (default: "ZakupkikgCompanyRef")
    • id integer nullable
    • inn string nullable
    • name string nullable
  • lot_id string nullable
  • lot_number string nullable
  • lot_name string nullable
  • position integer nullable
  • amount number nullable
  • bid_amount number nullable
  • is_selected boolean nullable
  • note string nullable
• evaluation_protocols array (default: [])
  • @type string (default: "ZakupkikgFile")
  • id string nullable
  • name string nullable
• contracts array (default: [])
  • @type string (default: "ZakupkikgTenderContract")
  • id string nullable
  • number string nullable
  • status string nullable
  • contract_date string nullable
  • supplier object nullable
    • @type string (default: "ZakupkikgCompanyRef")
    • id integer nullable
    • inn string nullable
    • name string nullable
  • created_by string nullable
  • created_at integer nullable
  • bid_id string nullable
  • lots array (default: [])
    • @type string (default: "ZakupkikgContractLot")
    • lot_id string nullable
    • lot_number string nullable
    • lot_name string nullable
    • delivery_place string nullable
    • lot_amount number nullable
    • bid_amount number nullable
    • contract_amount number nullable
    • price_after_discount number nullable
    • products array (default: [])
  • payments array (default: [])
    • @type string (default: "ZakupkikgPayment")
    • payment_type string nullable
    • condition string nullable
    • date string nullable
    • due_date string nullable
    • files array (default: [])
  • schedules array (default: [])
    • @type string (default: "ZakupkikgSchedule")
    • delivery_place string nullable
    • delivery_condition string nullable
    • date_from string nullable
    • date_to string nullable
    • files array (default: [])

Errors

• 422 — The value is not a 24-character tender id or a tender URL 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 published tender with that id 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.