Public Supplier Requests Get

Request

Fetch one supplier request by its public id (its UUID).

Path

supplier_request_idstring(Supplier Request Id)required

authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

curl -i -X GET \
  'https://docs.mercura.ai/_mock/openapi/supplier-requests/{supplier_request_id}' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json

idstring(Id)required

Public id — the supplier request's UUID.

Example:"b3f1c2a4-6d9e-4f21-a0b7-2c5e8d1f9a44"

statusstring(PublicSupplierRequestStatus)required

Lifecycle state of a supplier request.

A translated subset of the internal SupplierRequestStatus; the mapping lives in supplier_requests.service._SUPPLIER_REQUEST_STATUS_MAP and a test asserts it covers every internal value. New values may be added in a MINOR release — the OpenAPI enum is closed, so consumers should treat an unknown value defensively rather than fail strict validation.

Enum:"REQUEST_SENT""OFFER_RECEIVED""DECLINED"

Example:"OFFER_RECEIVED"

tender_idstring or null(Tender Id)

Backing tender id when the request is tender-scoped — resolve via GET /tenders/{tender_id}. Null when project-scoped.

Example:"12345"

project_idstring or null(Project Id)

Backing project id when the request is project-scoped — resolve via GET /projects/{project_id}. Null when tender-scoped.

supplier_idstring or null(Supplier Id)

Supplier reference only — resolve full details via GET /suppliers/{supplier_id}. Null when no supplier is set.

Example:"SUP-3001"

supplier_namestring or null(Supplier Name)

Supplier display name (convenience mirror of the reference).

Example:"Nordlicht Leuchten GmbH"

supplier_emailsArray of strings(Supplier Emails)

Recipient email addresses the request was sent to.

Example:

[
  "angebot@nordlicht-leuchten.de"
]

sender_emailstring or null(Sender Email)

Email of the Mercura user who sent the request. Null when unknown.

Example:"einkauf@grosshandel.de"

is_awardedboolean(Is Awarded)required

True when at least one offered line was accepted into the final tender.

Example:true

awarded_line_countinteger(Awarded Line Count)required

Number of offered lines accepted into the final tender.

Example:1

offered_linesArray of objects(Offered Lines)

Example:

[
  {
    "article_number": "LEU-48210",
    "candidate_status": "ACCEPTED",
    "description": "LED-Einbauleuchte 4000K, 24W",
    "id": "5521",
    "item_type": "ARTICLE",
    "line_total": "4620.00",
    "manufacturer_article_number": "NL-LED-4000K",
    "position_id": "90112",
    "quantity": 120,
    "selected": true,
    "unit": "Stk",
    "unit_price": "38.50"
  },
  {
    "article_number": "LEU-48477",
    "candidate_status": "PENDING",
    "description": "LED-Panel 62x62, 36W",
    "id": "5522",
    "item_type": "ARTICLE",
    "line_total": "2880.00",
    "position_id": "90113",
    "quantity": 40,
    "selected": false,
    "unit": "Stk",
    "unit_price": "72.00"
  }
]

created_atstring, (date-time)(Created At)required

Example:"2026-07-14T09:12:00Z"

updated_atstring, (date-time)(Updated At)required

Example:"2026-07-16T14:05:11Z"

Response

{
  "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": [
    "angebot@nordlicht-leuchten.de"
  ],
  "supplier_id": "SUP-3001",
  "supplier_name": "Nordlicht Leuchten GmbH",
  "tender_id": "12345",
  "updated_at": "2026-07-16T14:05:11Z"
}