Skip to content
/
Filtering

Filtering

All filters are optional and composable:

  • tender_id — only supplier requests raised for one tender. This is the authoritative "all supplier requests for this tender" query:

    GET /supplier-requests?tender_id=48213

  • project_id — only supplier requests raised for one project (a distinct axis from tender_id).

  • supplier_id — only requests sent to one supplier (its external_id).

  • status — filter by lifecycle state, e.g. status=OFFER_RECEIVED.

  • awarded — awarded=true returns only requests with at least one accepted (selected) line — i.e. the suppliers you are actually buying from; false returns those without one.

  • modified_since — ISO-8601 lower bound on updated_at for delta-sync catch-up scans (first page only; the cursor supersedes it thereafter).

# only the awarded requests for one tender
GET /supplier-requests?tender_id=48213&awarded=true

# one supplier's request on a tender that came back with an offer
GET /supplier-requests?tender_id=48213&supplier_id=SUP-1007&status=OFFER_RECEIVED