---
title: "List all data events"
method: GET
path: "/events"
tags: ["Data Events"]
---

# List all data events

`GET /events`

> 🚧
>
> Please note that you can only 'list' events that are less than 90 days old. Event counts and summaries will still include your events older than 90 days but you cannot 'list' these events individually if they are older than 90 days

The events belonging to a customer can be listed by sending a GET request to `https://api.intercom.io/events` with a user or lead identifier along with a `type` parameter. The identifier parameter can be one of `user_id`, `email` or `intercom_user_id`. The `type` parameter value must be `user`.

- `https://api.intercom.io/events?type=user&user_id={user_id}`
- `https://api.intercom.io/events?type=user&email={email}`
- `https://api.intercom.io/events?type=user&intercom_user_id={id}` (this call can be used to list leads)

The `email` parameter value should be [url encoded](http://en.wikipedia.org/wiki/Percent-encoding) when sending.

You can optionally define the result page size as well with the `per_page` parameter.

## Query parameters

- `filter` union, required
  - object
    - `user_id` string, required
  - object
    - `intercom_user_id` string, required
  - object
    - `email` string, required
- `type` string, required
- `summary` boolean

## Headers

- `Intercom-Version` '1.0' | '1.1' | '1.2' | '1.3' | '1.4' | '2.0' | '2.1' | '2.2' | '2.3' | '2.4' | '2.5' | '2.6' | '2.7' | '2.8' | '2.9' | '2.10' | '2.11' | '2.12' | '2.13' | '2.14' — Intercom API version.</br>By default, it's equal to the version set in the app package.

## Response `200`

Successful response

- DataEventSummary — This will return a summary of data events for the App.
  - `type` 'event.summary' — The type of the object
  - `email` string — The email address of the user
  - `intercom_user_id` string — The Intercom user ID of the user
  - `user_id` string — The user ID of the user
  - `events` DataEventSummaryItem[] — A summary of data events
    - `name` string — The name of the event
    - `first` string — The first time the event was sent
    - `last` string — The last time the event was sent
    - `count` integer — The number of times the event was sent
    - `description` string — The description of the event

## Other responses

- `401` — Unauthorized

---

[API](https://skmtc.net/intercom/apis/intercom-api.md) · [All operations](https://skmtc.net/intercom/apis/intercom-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/intercom/intercom-api/revisions/9517e80f2642/schema)