Events

Retrieve an event with the given ID.

get/v1/events/{id}

Request

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

Path parameters

idstring required

The unique id for the event

Response

OK

idstring

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_atstring date-time

The date and time the event was created

associated_object_idstring

The unique identifier for the associated object

associated_object_typestring

The type of the associated object

organization_idstring

The unique identifier for the organization the event belongs to

Example response

{
  "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

  • 2026-10-0123145538add0Revision changes
    • warning

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

    • info

      added the optional property to the response with the status