Public Customers Get

Request

Fetch one customer by its partner-supplied customer_id.

Path

customer_idstring(Customer 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/customers/{customer_id}' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json

idstring or null(Id)

Public id; equals the customer's customer_id when present

Example:"K-10042"

customer_idstring or null(Customer Id)

Example:"K-10042"

namestring(Name)required

Example:"Elektro Mustermann GmbH"

vat_idstring or null(Vat Id)

Example:"DE123456789"

emailsArray of strings(Emails)

Example:

[
  "einkauf@mustermann-elektro.example"
]

addressobject(Address)

Postal address shared across customers and suppliers.

Example:

{
  "city": "Düsseldorf",
  "country": "DE",
  "is_default": true,
  "kind": "billing",
  "postal_code": "40210",
  "region": "NRW",
  "street": "Industriestraße",
  "street_number": "12"
}

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 customer carries none. On duplicate labels the field defined first (by display order, then creation time) wins.

Example:

{
  "Kundengruppe": "Elektrogroßhandel",
  "Zahlungsziel": "30 Tage netto"
}

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

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

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

Example:"2026-07-12T14:22:10Z"

Response

{
  "address": {
    "city": "Düsseldorf",
    "country": "DE",
    "is_default": true,
    "kind": "billing",
    "postal_code": "40210",
    "region": "NRW",
    "street": "Industriestraße",
    "street_number": "12"
  },
  "created_at": "2026-02-03T10:15:00Z",
  "custom_fields": {
    "Kundengruppe": "Elektrogroßhandel",
    "Zahlungsziel": "30 Tage netto"
  },
  "customer_id": "K-10042",
  "emails": [
    "einkauf@mustermann-elektro.example"
  ],
  "id": "K-10042",
  "name": "Elektro Mustermann GmbH",
  "updated_at": "2026-07-12T14:22:10Z",
  "vat_id": "DE123456789"
}