List events for an item

Returns a paginated, chronological list of all history events for an item, including
comments, status and level changes, assignments, title changes, snoozes, and merges.
System-generated events and comments authored by system users are included.
Snooze history is omitted when the snooze feature is unavailable for the account;
explicitly requesting item_snooze_history in that case returns 403.

Project, account, and user-scoped account access tokens are supported when they have read access to the item's project.
An item with no matching events returns an empty events array with a 200 response.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
integer
required
≥ 1

The item ID

Query Params
integer

Project ID, required when using an Account Access Token with this endpoint.

integer

Page number, starting from 1. The default number of elements returned per page is 20. Set the limit parameter to update that.

integer

Sets the limit for number of items returned per page. Default is 20 and the max is 5000.

type
array of strings

Filter the history to one or more event types. Repeat the parameter for multiple types.
Omit it to return all item history event types.
Requesting item_snooze_history requires the snooze feature to be enabled for the account.

type
Headers
string
required

Use a Project or Account Access Token with 'read' scope (Account tokens require a project_id to be specified)

Responses

400

Invalid item ID or event type.

403

The token lacks read scope or project access, or unavailable snooze history was requested.

404

The item does not exist in the token's project.

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json; charset=utf-8