ticket_history

List /ticket_history

List ticket history entries, the CRM ticket Changelog: who did what and when (ticket created, status, assignee or department changes, forwarded, known problem linked, files, ...). One entry per action; description is the plain-text list of changes. Use filter[ticket] for one ticket or filter[created_since] to poll across tickets. Ticket views are not included; causer is null for system actions (email import, automations) or when the author no longer exists. Response: items and pagination. At least one of filter[ticket], filter[created_since] or filter[created_at] is required.

GET

/ticket_history

curl --request GET \
  --url 'https://default.hannacrm.app/api/v4/ticket_history?page=123&per_page=123&filter%5Bticket%5D=%3Cstring%3E&filter%5Bcreated_since%5D=2023-11-07T05%3A31%3A56Z&filter%5Bcreated_at%5D=%3Cstring%3E&filter%5Bevent%5D=%3Cstring%3E&sort=%3Cstring%3E&fields=%3Cstring%3E' \
  --header 'Authorization: Bearer <token>'

{
  "items": [
    {
      "causer": {
        "name": "<string>",
        "type": "staff",
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      },
      "created_at": "2023-11-07T05:31:56Z",
      "description": "<string>",
      "event": "<string>",
      "ticket": {
        "subject": "<string>",
        "uuid": "3c90c3cc-0d44-4b50-8888-8dd25736052a"
      }
    }
  ],
  "pagination": {
    "from": 123,
    "last_page": 123,
    "page": 123,
    "per_page": 123,
    "to": 123,
    "total": 123
  },
  "query": "<string>"
}

Authorizations

Authorizationstringheaderrequired

API key (Bearer token) created in Setup → API & MCP.

Query Parameters

pageintegerquery

Page number (1-based).

Required range: 1 <= x

per_pageintegerquery

Number of results per page.

Required range: 1 <= x <= 25

filter[ticket]stringquery

Ticket UUIDs: the history of these tickets.

filter[created_since]stringquery

Return only entries at or after this ISO 8601 timestamp (e.g. 2026-09-01T00:00:00Z). Intended for polling recent history across tickets: keep the window recent (days) and read older history per ticket with ticket. Every page counts all matching entries first, so a wide window is slow on a large tenant.

filter[created_at]stringquery

Entry date range (YYYY-MM-DD - YYYY-MM-DD). A range that cannot be read matches nothing. Keep the range recent and read older history per ticket with ticket: every page counts all matching entries first, so a wide range is slow on a large tenant.

filter[event]stringquery

Event types, lowercase: created, updated, deleted, restored, other. Any other value, a different letter case included (views are never part of the history), is rejected with 422.

sortstringquery

Optional sort order, comma-separated; prefix a field with - for descending (e.g. sort=-updated_at); empty values sort last. Sortable fields: created_at, event. Default when omitted: -created_at,-id.

fieldsstring[]query

Optional response field paths (dot notation for nested groups, e.g. billing_address.street; array fields are returned whole). Comma-separated string is also accepted. Identifier field is always included.

Response

Search results

itemsobject[]

Show child attributes

paginationobject

Show child attributes

querystring

Still need help? Ask the team