Events

List all events corresponding to your Chariot account.

get/v1/events

Request

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

Query parameters

limitinteger

Limit the size of the list that is returned. The default (and maximum) is 100 objects.

cursorstring

The cursor to use for pagination. If not set, the first page of results will be returned.

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.

Filter Events for those with the specified category.

Response

The response for Events.list

nextPageTokenstring

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.

Example response

{
  "results": [
    {
      "id": "203c4e56-5c39-4a66-abcd-2ec8af99a1b9",
      "created_at": "2024-01-19T18:48:56.37Z",
      "associated_object_id": "4d06d393-1f14-46cf-b02d-8db17d7ed06a",
      "associated_object_type": "grant",
      "organization_id": "org_01jpjenf5q6cawy43yxfcrxhct"
    }
  ]
}

Changes

  • 2026-10-01d2a4ff2fdda5Revision changes
    • warning

      added the new donation.deleted enum value to the // response property for the response status

    • info

      added the new enum value donation.deleted to the query request parameter category

  • 2026-10-0123145538add0Revision changes
    • warning

      added the new connection.revoked enum value to the // response property for the response status

    • info

      added the new enum value connection.revoked to the query request parameter category

    • info

      added the optional property // to the response with the status