ДескусДескус · Документация
Все разделыСправочник · Тикеты

GET /tickets — список тикетов

Тикеты компании, новые сверху, страницами по курсору. Право — tickets:read.

Запрос

curl "https://app.deskus.ru/api/v1/tickets?status=new,open&updated_since=2026-10-21T00:00:00Z&limit=50" \
  -H "Authorization: Bearer $DESKUS_KEY"

Ответ 200

{
  "data": [
    {
      "id": "0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10",
      "number": "T-1042",
      "subject": "Не пришёл заказ №4821",
      "status": "new",
      "priority": null,
      "channel": "API",
      "client_id": "5f1a9e7c-2b3d-4e8f-a0c1-7d6b5e4f3a21",
      "assignee_id": null,
      "team_id": null,
      "merged_into_id": null,
      "snoozed_until": null,
      "created_at": "2026-10-21T09:15:04.218Z",
      "updated_at": "2026-10-21T09:15:04.218Z",
      "last_activity_at": "2026-10-21T09:15:04.218Z",
      "closed_at": null,
      "url": "https://app.deskus.ru/tickets/0b8f6c1e-5d2a-4c7b-9a31-6e2f7d4c9a10"
    }
  ],
  "next_cursor": null
}

Параметры

Параметр

Что делает

status

Через запятую: new,open,waiting,snoozed,closed

client_id

Тикеты клиента

assignee_id

Тикеты сотрудника

channel

Точная подпись канала: API, Telegram, Email

q

Поиск по теме и номеру, до 200 знаков

updated_since

Изменённые с этого времени, ISO 8601 — для синхронизации

created_since

Созданные с этого времени

include_merged

true — показать и слитые тикеты; по умолчанию их нет, чтобы не дублировать основной

limit, cursor

Страница (постраничный вывод)

Ошибки

  • 400 bad_request — неизвестный статус, client_id не UUID, время не в ISO 8601, битый курсор.

  • 403 insufficient_scope — у ключа нет tickets:read.

Не нашли ответ? Напишите нам
Поддержка ответит в рабочее время.
Вы сотрудник «Дескус»?Изменить статью в Дескусе