---
title: "List all events"
method: GET
path: "/v1/events"
---

# List all events

`GET /v1/events`

List events, going back up to 30 days. Each event data is rendered according to Stripe API version at its creation time, specified in [event object](https://docs.stripe.com/api/events/object) `api_version` attribute (not according to your current Stripe API version or `Stripe-Version` header).

## Query parameters

- `created` union
  - object
    - `gt` integer
    - `gte` integer
    - `lt` integer
    - `lte` integer
  - integer
- `delivery_success` boolean
- `ending_before` string
- `expand` string[]
- `limit` integer
- `starting_after` string
- `type` string
- `types` string[]

## Response `200`

Successful response.

- object
  - `data` Event[], required
    - `account` string — The connected account that originates the event.
    - `api_version` string, nullable — The Stripe API version used to render `data` when the event was created. The contents of `data` never change, so this value remains static regardless of the API version currently in use. This property is populated only for events created on or after October 31, 2014.
    - `context` string — Authentication context needed to fetch the event or related object.
    - `created` integer, required — Time at which the object was created. Measured in seconds since the Unix epoch.
    - `data` NotificationEventData, required
      - `object` object, required — Object containing the API resource relevant to the event. For example, an `invoice.created` event will have a full [invoice object](https://api.stripe.com#invoice_object) as the value of the object key.
      - `previous_attributes` object — Object containing the names of the updated attributes and their values prior to the event (only included in events of type `*.updated`). If an array attribute has any updated elements, this object contains the entire array. In Stripe API versions 2017-04-06 or earlier, an updated array attribute in this object includes only the updated array elements.
    - `id` string, required — Unique identifier for the object.
    - `livemode` boolean, required — If the object exists in live mode, the value is `true`. If the object exists in test mode, the value is `false`.
    - `object` 'event', required — String representing the object's type. Objects of the same type share the same value.
    - `pending_webhooks` integer, required — Number of webhooks that haven't been successfully delivered (for example, to return a 20x response) to the URLs you specify.
    - `request` NotificationEventRequest
      - `id` string, nullable — ID of the API request that caused the event. If null, the event was automatic (e.g., Stripe's automatic subscription handling). Request logs are available in the [dashboard](https://dashboard.stripe.com/logs), but currently not in the API.
      - `idempotency_key` string, nullable — The idempotency key transmitted during the request, if any. *Note: This property is populated only for events on or after May 23, 2017*.
    - `type` string, required — Description of the event (for example, `invoice.created` or `charge.refunded`).
  - `has_more` boolean, required — True if this list has another page of items after this one that can be fetched.
  - `object` 'list', required — String representing the object's type. Objects of the same type share the same value. Always has the value `list`.
  - `url` string, required — The URL where this list can be accessed.

## Other responses

- `default` — Error response.

---

[API](https://skmtc.net/stripe/apis/spec3.md) · [All operations](https://skmtc.net/stripe/apis/spec3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/stripe/spec3/revisions/3653ad45bbec/schema)