Public Contacts List

Request

Cursor-paginated list of contacts.

Query

parent_typestring(Parent Type)

Filter to contacts on a specific parent kind (customer or supplier).

Enum:"customer""supplier"

parent_idstring or null, <= 255 characters(Parent Id)^[A-Za-z0-9._\-]{1,255}$

Filter to contacts under one specific parent's partner-supplied id. Requires parent_type so the same id under both kinds cannot collide.

is_activeboolean or null(Is Active)

Filter by active flag. Omit to return both active and soft-deleted contacts.

cursorstring or null(Cursor)

Opaque cursor from prior page

modified_sincestring or null, (date-time)(Modified Since)

ISO-8601 lower bound on updated_at. Applied only on the first page; the cursor is a strict super-set thereafter.

limitinteger or null, [ 1 .. 500 ](Limit)

authorizationstring or null(Authorization)

Bearer <mrc_live_…> API key

curl -i -X GET \
  'https://docs.mercura.ai/_mock/openapi/contacts?parent_type=customer&parent_id=string&is_active=true&cursor=string&modified_since=2019-08-24T14%3A15%3A22Z&limit=1' \
  -H 'authorization: string'

Responses

Successful Response

Bodyapplication/json

dataArray of objects(Data)required

Example:

[
  {
    "created_at": "2026-02-03T10:16:00Z",
    "email": "t.weber@mustermann-elektro.example",
    "external_id": "ASP-00815",
    "id": 5567,
    "is_active": true,
    "is_default": true,
    "name": "Thomas Weber",
    "parent_id": "K-10042",
    "parent_type": "customer",
    "phone": "+49 211 5551020",
    "updated_at": "2026-07-05T11:03:00Z"
  }
]

next_cursorstring or null(Next Cursor)

Response

{
  "data": [
    { … }
  ],
  "next_cursor": "string"
}