Public Suppliers Get

Request

Fetch one supplier by its partner-supplied supplier_id.

Path

supplier_idstring(Supplier Id)^[A-Za-z0-9._\-]{1,255}$required

authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

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

Responses

Successful Response

Bodyapplication/json

idstring or null(Id)

Public id; equals the supplier's supplier_id when present

Example:"L-2001"

supplier_idstring or null(Supplier Id)

Example:"L-2001"

namestring(Name)required

Example:"Lumaris Leuchten GmbH"

emailsArray of strings(Emails)

Example:

[
  "vertrieb@lumaris.example"
]

custom_fieldsobject or null(Custom Fields)

Organisation-defined custom fields, keyed by the field's display label (v1.9.0; previously keyed by the internal column UUID). Columns with no active definition are omitted; null when the supplier carries none. On duplicate labels the field defined first (by display order, then creation time) wins.

Example:

{
  "Kreditor-Nr": "70012",
  "Lieferantengruppe": "Leuchten"
}

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

Example:"2026-02-03T10:20:00Z"

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

Example:"2026-07-10T08:05:00Z"

Response

{
  "created_at": "2026-02-03T10:20:00Z",
  "custom_fields": {
    "Kreditor-Nr": "70012",
    "Lieferantengruppe": "Leuchten"
  },
  "emails": [
    "vertrieb@lumaris.example"
  ],
  "id": "L-2001",
  "name": "Lumaris Leuchten GmbH",
  "supplier_id": "L-2001",
  "updated_at": "2026-07-10T08:05:00Z"
}