Skip to content

Public Users List By Email

Request

Look a user up by email.

Returns a CursorPage with the matching user(s), or an empty data array when the email is unknown in your organisation (never a 404 — the status code doesn't reveal which emails exist). Almost always a single match, but email is not guaranteed unique: if more than one user shares an email, all are returned so you can disambiguate by id. next_cursor is always null — every match fits in one page. Use this to resolve a tender's user_email to the user's custom_fields (e.g. an ERP/SAP id).

Query
emailstring, (email)(Email)required

Email to look up (case-insensitive, exact match). Typically the user_email returned by GET /tenders. Required.

Headers
authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

curl -i -X GET \
  'https://docs.mercura.ai/_mock/openapi/users?email=user%40example.com' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json
dataArray of objects(Data)required
Example:
[ { "created_at": "2026-01-05T08:00:00Z", "custom_fields": {}, "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" } ]
next_cursorstring or null(Next Cursor)
Response
{ "data": [ {} ], "next_cursor": "string" }