List events for an item

get

https://api.rollbar.com/api/1/item/{item_id}/events

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

Time	Status	User Agent
Retrieving recent requests…

Loading…

Path Params

item_id

integer

required

≥ 1

The item ID

Query Params

project_id

integer

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

page

integer

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

limit

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

X-Rollbar-Access-Token

string

required

Use a Project or Account Access Token with 'read' scope. An Account Access Token names the project with project_id on an endpoint that acts on one project, and a personal access token can do only what its user is permitted to.

string

enum

Defaults to application/json; charset=utf-8

Generated from available response content types

Allowed:

Responses

`project_ids` that the token can't read are left out of the query, and the request is refused only when none are left. Also returned when the account's plan doesn't include the Metrics API.

Language

Loading…

Response

Click Try It! to start a request and see the response here! Or choose an example:

application/json; charset=utf-8

application/json

200Success

400The request could not be parsed, or a parameter is not in a form the endpoint accepts.

401The access token is missing, or is not in the form of a Rollbar access token.

403The access token is not authorized for any of the requested projects. Projects in project_ids that the token can't read are left out of the query, and the request is refused only when none are left. Also returned when the account's plan doesn't include the Metrics API.

404The token's project or account could not be found.

429The access token is over its rate limit.

`project_ids` that the token can't read are left out of the query, and the request is refused only when none are left. Also returned when the account's plan doesn't include the Metrics API.