List callbacks (desk:write)
GET /api/desk/v1/callbacks
Module: Desk · operationId: listCallbacks · Tag: Callbacks · Auth: access token (Authorization: Bearer <accessToken>)
Callbacks (Rückrufe) with the total, openMine (the caller's open callbacks, the header badge) and
openUnassigned (open callbacks without a responsible person). scope mine lists the callbacks the caller is
responsible for, unassigned the pool of callbacks nobody is responsible for yet (responsible is ignored),
all everyone's (default). status is open (no
closed flag), closed, any (default) or a key of the value list callbackStatus. Sorted by desired time
(without one last), then newest (sort=due, default), or newest first by created / updated.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
scope |
query | string | (one of mine, unassigned, all; default "all") |
|
status |
query | string | open, closed, any (default) or a callbackStatus key | |
responsible |
query | string | User ref of the responsible person | |
customerId |
query | string | Masterdata address id | |
reason |
query | string | Key of a callbackReason entry | |
q |
query | string | Phone, contact name, customer name, note or number | |
from |
query | string (date-time) | Desired time from (date or RFC 3339) | |
to |
query | string (date-time) | Desired time before | |
sort |
query | string | (one of due, created, updated; default "due") |
|
limit |
query | integer | 1–200; another value is a 400 invalid. (default 50; max 200) |
|
offset |
query | integer |
Responses
- 200 A page of callbacks (
application/json) - 400 Error (
application/json) - 403 Error (
application/json)
Fields of the 200 answer:
items(array of Callback, required): Callbacks of the pageclosed(boolean, read-only): The status carries the closed flagclosedAt(string (date-time), nullable): When the callback was closedclosedBy(string): Login (e-mail) of who closed the callbackcontact(object): Masterdata contact snapshot (only with a customer)contactName(string): Name of the person to call backconvertedAt(string (date-time), nullable): When the callback was turned into a ticketcreatedAt(string (date-time)): When the callback was createdcreatedBy(string): Login (e-mail) of who created the callbackcreatedByName(string): Name of who created the callbackcustomFields(object): Values of the fields of settings.callbacks.fields, keyed without cf.customer(object): Masterdata address snapshotcustomerMail(object): Only in the answer of a create or status change into a status with a customer mail: the draft of a manual mail; for an automatic one the mail as queued (modeauto, nomissing) or, when it was not sent, why (missing). Never on reads.desiredAt(string (date-time), nullable): When the contact wants to be called backdesiredHasTime(boolean): false: only the day of desiredAt countsdoneNote(string): Result of the callid(string (uuid)): Id of the callbackitem(ItemSummary)id(string): Id of the itemnumber(integer): Number of the itemphase(Phase)spaceId(string): Space of the itemstatus(string): Status keytitle(string): TitletypeId(string): Type of the item
itemId(string, nullable): The ticket it becamenote(string): Note of the callbacknumber(integer): Per tenantorigin(string): The call it was made from in Arbeitsplatz › Aktivitäten (comms:interaction:<id>,comms:calendar:<id>); "" noneoverdue(boolean, read-only): Open and the desired time (without time: the desired day) has passedphone(string): Phone number to call backreason(string): Key of a callbackReason entry, "" = noneresponsibleName(string): Name of the person responsibleresponsibleRef(string): User ref of the person who calls back; "" = nobody yet (the pool of unassigned callbacks)status(string): Key of a callbackStatus entryupdatedAt(string (date-time)): When the callback was last changedversion(integer): Version of the callback; send it back on change (409 version_conflict when it is outdated)
openMine(integer, required): Open callbacks the caller is responsible foropenUnassigned(integer, required): Open callbacks without a responsible person (the pool)total(integer, required): Number of callbacks matching the filter
Example 200 answer:
{
"items": [
{
"closed": false,
"contactName": "Katrin Stadler",
"createdAt": "2026-11-17T15:20:00Z",
"customer": {
"id": "3c5e7a9c-1d3f-4b5a-9c7e-1a3c5e7a9c11",
"name": "Alpenhotel Seeblick GmbH \u0026 Co. KG"
},
"desiredAt": "2026-11-19T08:00:00Z",
"desiredHasTime": true,
"id": "7b4c5d6e-8f9a-4b0c-9d2e-4f5a6b7c8d01",
"note": "Frau Stadler möchte kurz zur Kassenanbindung sprechen, bevor die Frühschicht beginnt.",
"number": 12,
"overdue": false,
"phone": "+49 8652 987612",
"reason": "callback_requested",
"responsibleName": "Elias Gruber",
"responsibleRef": "elias.gruber@muster-it.example",
"status": "open",
"updatedAt": "2026-11-17T15:20:00Z",
"version": 1
}
],
"openMine": 1,
"openUnassigned": 2,
"total": 1
}
Example request
curl -X GET 'https://api.mbcom.cloud/api/desk/v1/callbacks' \
-H "Authorization: Bearer $ACCESS_TOKEN"