Skip to content
/
Public Users Get

Public Users Get

Request

Fetch one user by their Mercura user id.

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

The Mercura user id — the id field from a GET /users response.

Headers
authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

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

Responses

Successful Response

Bodyapplication/json
idstring(Id)required

Mercura user id (stable UUID). This is the id used across the API to reference the user; pass it to GET /users/{user_id}.

Example:"3f8b6d21-9a4c-4e77-b0e2-1c5d8a9f4e10"
emailstring(Email)required

The user's login email — matches the tender's user_email.

Example:"anna.schmidt@example.com"
namestring(Name)required
Example:"Anna Schmidt"
external_idstring or null(External Id)

External / employee id from your HR or ERP system, when set on the user.

Example:"MA-1042"
rolestring or null(Role)

The user's role within the organisation (e.g. ADMIN, MANAGER, MEMBER).

Example:"MEMBER"
languagestring(Language)required

The user's UI language as an upper-case ISO 639-1 code (e.g. DE, EN).

Example:"DE"
is_activeboolean(Is Active)required

Whether the user is active in Mercura.

Example:true
custom_fieldsobject or null(Custom Fields)

Organisation-defined custom fields, keyed by the field's display label (e.g. an ERP/SAP id used for offer creation). Columns with no active definition are omitted; null when the user carries none. On duplicate labels the field defined first (by display order, then creation time) wins.

Example:
{
  "SAP-Benutzer": "SAP0042"
}
created_atstring, (date-time)(Created At)required
Example:"2026-01-05T08:00:00Z"
updated_atstring, (date-time)(Updated At)required
Example:"2026-06-30T16:45:00Z"
Response
{
  "created_at": "2026-01-05T08:00:00Z",
  "custom_fields": {
    "SAP-Benutzer": "SAP0042"
  },
  "email": "anna.schmidt@example.com",
  "external_id": "MA-1042",
  "id": "3f8b6d21-9a4c-4e77-b0e2-1c5d8a9f4e10",
  "is_active": true,
  "language": "DE",
  "name": "Anna Schmidt",
  "role": "MEMBER",
  "updated_at": "2026-06-30T16:45:00Z"
}