---
title: "List Event Subscriptions"
method: GET
path: "/v1/event_subscriptions"
tags: ["Event Subscriptions"]
---

# List Event Subscriptions

`GET /v1/event_subscriptions`

List all event subscriptions corresponding to your Chariot account.

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

The response for Events.list

- object
  - `results` EventSubscription[]
    - `id` string — The unique identifier for the event subscription
    - `created_at` string, date-time — The date and time the event subscription was created
    - `status` 'active' | 'disabled' | 'deleted' | 'requires_attention' — The status of the event subscription. This indicates if we'll send notifications to this subscription * active: subscription is active and events will be delivered normally * disabled: subscription is temporarily disabled and events will not be delivered * deleted: subscription has been deleted and events will not be delivered * requires_attention: subscription has been disabled due to delivery failures and events will not be delivered
    - `url` string, required — The webhook url where we'll send notifications.
    - `category` 'grant.created' | 'grant.updated' | 'unintegrated_grant.created' | 'unintegrated_grant.updated' — The category of the event. This is useful for filtering events.
  - `nextPageToken` string — A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the pageToken). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `500` — Internal Server Error

---

[API](https://skmtc.net/chariot-giving/apis/chariot-api-3.md) · [All operations](https://skmtc.net/chariot-giving/apis/chariot-api-3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/chariot-api-3/versions/bf5e4b95459a/schema)