/gem/bids

POST /api/gem/bids

Price: 20 credits

One GeM bid or reverse auction by its number: the listing fields plus what its bid document states — publication date, opening time, offer validity, buyer organisation and office, item categories, estimated value, turnover and experience criteria, required seller documents, auto-extension, EMD and performance-security terms, MSE and MII purchase preferences, evaluation method and RA rule.

How to use it

`end_at` is the current end time and moves when the buyer extends the bid, while `document_end_at` is the end time printed in the bid document. A reverse auction's document states only its own dates, organisation, item category, turnover and extension rule; the specifications live in the parent bid, so pass `parent_id` here for them.

Parameters

• access-token string required

Request body

• timeout integer — Max scrapping execution timeout (in seconds) (default: 300; min: 20; max: 1500)
• id string required — GeM bid or reverse-auction number (examples: "GEM/2026/B/7943100", "GEM/2026/R/739676"; minLength: 1)

Response

• @type string (default: "GemBidDetail")
• id string required
• numeric_id string required
• bid_type string nullable
• parent_id string nullable
• parent_numeric_id string nullable
• category string nullable
• category_id string nullable
• boq_title string nullable
• is_boq boolean nullable
• is_new_boq boolean nullable
• quantity integer nullable
• ministry string nullable
• department string nullable
• created_by string nullable
• start_at integer nullable
• end_at integer nullable
• is_cancelled boolean nullable
• status_code string nullable
• evaluation_status string nullable
• ra_status_code string nullable
• ra_evaluation_status string nullable
• evaluation_type_code string nullable
• type_code string nullable
• bid_to_ra_code string nullable
• ra_to_bid_code string nullable
• bunch_code string nullable
• is_custom_item boolean nullable
• is_high_value boolean nullable
• is_global_tender boolean nullable
• is_rate_contract boolean nullable
• is_single_packet boolean nullable
• schedules array (default: [])
  • @type string (default: "GemBidSchedule")
  • id string nullable
  • status_code string nullable
  • is_awarded boolean nullable
• parent_schedules array (default: [])
  • @type string (default: "GemBidSchedule")
  • id string nullable
  • status_code string nullable
  • is_awarded boolean nullable
• document_url string nullable
• published_date string nullable
• document_end_at integer nullable
• opening_at integer nullable
• offer_validity_days integer nullable
• organisation string nullable
• office string nullable
• grievance_contact string nullable
• item_categories string nullable
• relevant_categories string nullable
• primary_product_category string nullable
• similar_category string nullable
• estimated_value number nullable
• contract_period string nullable
• min_turnover string nullable
• oem_min_turnover string nullable
• turnover_criteria string nullable
• past_experience_years string nullable
• past_performance string nullable
• mse_relaxation string nullable
• startup_relaxation string nullable
• documents_required string nullable
• is_documents_shown_to_bidders boolean nullable
• min_bids_to_stop_extension integer nullable
• auto_extension_days integer nullable
• auto_extension_count integer nullable
• is_bid_to_ra_enabled boolean nullable
• packet_type string nullable
• ra_rule string nullable
• technical_clarification_time string nullable
• is_inspection_required boolean nullable
• evaluation_method string nullable
• has_arbitration_clause boolean nullable
• has_mediation_clause boolean nullable
• is_emd_required boolean nullable
• emd_amount number nullable
• emd_advisory_bank string nullable
• is_epbg_required boolean nullable
• epbg_percentage number nullable
• epbg_duration_months integer nullable
• epbg_advisory_bank string nullable
• has_mii_purchase_preference boolean nullable
• has_mse_purchase_preference boolean nullable
• has_mii_compliance boolean nullable
• auto_extension_rule string nullable
• mse_price_margin_percentage number nullable
• mse_quantity_percentage number nullable
• document_pages integer 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 GeM bid or reverse auction carries that number 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.