Tickets

List tickets

Returns the support tickets your workspace holds, newest first — the same object every `ticket.*` webhook carries, so a receiver and a poller can never disagree about what a ticket is.

GET/api/v1/tickets

Filter by status, poll on since (creation time), or narrow to one person with email. Messages are not included; fetch one ticket for its thread.

Query parameters

Prop

Type

Response 200

Returns a data array with a pagination object. Each item:

Prop

Type

Errors

  • 400 — Unknown status or an invalid since
  • 401 — Missing or invalid API key
  • 404 — Chatbot not found
  • 429 — Rate limit exceeded

Every error shares one envelope.

Example

curl https://www.hey.support/api/v1/tickets \
  -H 'Authorization: Bearer hs_live_…'