Public Supplier Requests List

Request

Cursor-paginated list of supplier requests for the authed organisation.

Query

cursorstring or null(Cursor)

Opaque cursor from a prior page.

modified_sincestring or null, (date-time)(Modified Since)

ISO-8601 lower bound on updated_at. Applied only on the first page; the cursor is a strict super-set thereafter.

tender_idstring or null(Tender Id)

Return only supplier requests raised for this tender (the tender's id from GET /tenders). Distinct from project_id.

project_idstring or null(Project Id)

Return only supplier requests raised for this project (project-scoped SRs).

supplier_idstring or null(Supplier Id)

Return only supplier requests sent to this supplier (its external_id).

statusstring(Status)

Filter by lifecycle state (REQUEST_SENT | OFFER_RECEIVED | DECLINED).

Enum:"REQUEST_SENT""OFFER_RECEIVED""DECLINED"

awardedboolean or null(Awarded)

true returns only supplier requests with at least one accepted (selected) line; false returns only those without one.

limitinteger or null, [ 1 .. 500 ](Limit)

authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

curl -i -X GET \
  'https://docs.mercura.ai/_mock/openapi/supplier-requests?cursor=string&modified_since=2019-08-24T14%3A15%3A22Z&tender_id=string&project_id=string&supplier_id=string&status=REQUEST_SENT&awarded=true&limit=1' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json

dataArray of objects(Data)required

Example:

[
  {
    "awarded_line_count": 1,
    "created_at": "2026-07-14T09:12:00Z",
    "id": "b3f1c2a4-6d9e-4f21-a0b7-2c5e8d1f9a44",
    "is_awarded": true,
    "offered_lines": [ … ],
    "sender_email": "einkauf@grosshandel.de",
    "status": "OFFER_RECEIVED",
    "supplier_emails": [ … ],
    "supplier_id": "SUP-3001",
    "supplier_name": "Nordlicht Leuchten GmbH",
    "tender_id": "12345",
    "updated_at": "2026-07-16T14:05:11Z"
  }
]

next_cursorstring or null(Next Cursor)

Response

{
  "data": [
    { … }
  ],
  "next_cursor": "string"
}