---
title: "List Events"
method: GET
path: "/v1/events"
tags: ["Events"]
---

# List Events

`GET /v1/events`

## Request

- Base URL: `https://sandboxapi.givechariot.com`
- URL: `https://sandboxapi.givechariot.com/v1/events`
- Auth: HTTP bearer

List all events corresponding to your Chariot account.

## Query parameters

- `limit` integer
- `cursor` string
- `category` 'grant.created' | 'grant.updated' | 'unintegrated_grant.created' | 'unintegrated_grant.updated' | 'donor_account.created' | 'donor_account.updated' | 'authorization_token.created' | 'authorization_token.updated' | 'grant_request.created' | 'grant_request.updated' | 'disbursement.created' | 'disbursement.updated' | 'inbound_transfer.created' | 'inbound_transfer.updated' | 'donation.created' | 'donation.updated' | 'donation.deleted' | 'deposit.created' | 'deposit.updated' | 'verification_request.created' | 'verification_request.updated' | 'connection.revoked': The category of the event. This is useful for filtering events. Event names follow the pattern `{resource}.{event_type}` where `event_type` is usually `created` or `updated`. Status transitions (for example, a Donor Account moving to `approved` or `rejected`) are emitted as `{resource}.updated` events — fetch the object to read its current status.

## Response `200`

The response for Events.list

- object
  - `results` Event[]
    - `id` string: The unique identifier for the event
    - `category` 'grant.created' | 'grant.updated' | 'unintegrated_grant.created' | 'unintegrated_grant.updated' | 'donor_account.created' | 'donor_account.updated' | 'authorization_token.created' | 'authorization_token.updated' | 'grant_request.created' | 'grant_request.updated' | 'disbursement.created' | 'disbursement.updated' | 'inbound_transfer.created' | 'inbound_transfer.updated' | 'donation.created' | 'donation.updated' | 'donation.deleted' | 'deposit.created' | 'deposit.updated' | 'verification_request.created' | 'verification_request.updated' | 'connection.revoked': The category of the event. This is useful for filtering events. Event names follow the pattern `{resource}.{event_type}` where `event_type` is usually `created` or `updated`. Status transitions (for example, a Donor Account moving to `approved` or `rejected`) are emitted as `{resource}.updated` events — fetch the object to read its current status.
    - `created_at` string, date-time: The date and time the event was created
    - `associated_object_id` string: The unique identifier for the associated object
    - `associated_object_type` string: The type of the associated object
    - `organization_id` string: The unique identifier for the organization the event belongs to
  - `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

## Changes

- **2026-11-02** (2026-10-01) `d2a4ff2fdda5`: 1 warning, 1 info
  - added the new `donation.deleted` enum value to the `results/items/category` response property for the response status `200`
  - added the new enum value `donation.deleted` to the `query` request parameter `category`
- **2026-10-29** (2026-10-01) `23145538add0`: 1 warning, 2 info
  - added the new `connection.revoked` enum value to the `results/items/category` response property for the response status `200`
  - added the new enum value `connection.revoked` to the `query` request parameter `category`
  - added the optional property `results/items/organization_id` to the response with the `200` status

[Operation history](https://skmtc.dev/chariot-giving/apis/chariot-api-5/changes/v1/events/get.md)

---

[API](https://skmtc.dev/chariot-giving/apis/chariot-api-5.md) - [All operations](https://skmtc.dev/chariot-giving/apis/chariot-api-5/llms.txt) - [OpenAPI document](https://skmtc.dev/chariot-giving/apis/chariot-api-5/revisions/d2a4ff2fdda5?raw)