CHchariot-giving
donations

List Donations

Changed on

List donations for your account. The list excludes deleted and merged donations. Fetch one by its ID with GET /v1/donations/{id}.

get/v1/donations

Request

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

Query parameters

limitinteger

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

page_tokenstring

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

source_idstring

The identifier of the source that sent the donations. Comma-separated list of source IDs.

payment_source_idstring

Deprecated. Use source_id. Comma-separated list of payment source IDs.

deposit_idstring

The unique identifier for the deposit to filter donations by.

created_at.afterstring date-time

Return donations created after the given date and time.

created_at.beforestring date-time

Return donations created before the given date and time.

dafpay_tracking_idstring

The DAFpay tracking identifier to filter donations by. Use this to reconcile a donation against the DAFpay grant that started it.

Response

The response for Donations.list

next_page_tokenstring

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": "donation_01j8rs605a4gctmbm58d87mvsj",
      "external_id": "INV-12345",
      "source_id": "source_01m12tn300eh20gdqscje7s5jw",
      "payment_source_id": "payment_source_01m12tn300eh20gdqscje7s5jw",
      "amount_gross": 25000,
      "amount_net": 25000,
      "amount_fee": 0,
      "individual_gift_amount": 25000,
      "currency": "USD",
      "donation_type": "daf",
      "frequency": "one_time",
      "effective_date": "2026-09-24T00:00:00Z",
      "created_by": {
        "name": "Chariot Data Sync"
      },
      "purpose": "Where needed most",
      "note": "Please dedicate in memory of grandma",
      "attribution": {
        "primary_donor": {
          "full_name": "Jane Rivera",
          "first_name": "Jane",
          "last_name": "Rivera",
          "email": "jrivera@example.com",
          "phone": "415-555-1212",
          "address": {
            "line1": "123 Main St.",
            "city": "New York",
            "state": "NY",
            "postal_code": "10001",
            "country": "US"
          }
        }
      },
      "initiation": {
        "initiated_at": "2026-09-20T15:04:05Z",
        "amount_initiated": 25000,
        "channel": "INTEGRATED",
        "web_location_url": "https://givebutter.com/example-nonprofit",
        "dafpay_tracking_id": "L9E182VBGP",
        "identifier": "L9E182VBGP",
        "form": "Givebutter",
        "metadata": {
          "campaign_id": "spring-appeal"
        }
      },
      "settlement": {
        "type": "chariot",
        "received_at": "2026-09-25T14:00:00Z",
        "settled_at": "2026-09-25T18:00:00Z",
        "deposit_id": "deposit_01j8rs605a4gctmbm58d87mvsj"
      },
      "grantor": {
        "organization_name": "Fidelity Charitable"
      },
      "donor_advised_fund_grant": {
        "donor_fund_name": "The Rivera Family Fund"
      },
      "metadata": {
        "crm_id": "0035e00000ABCDE"
      },
      "properties": [
        {
          "property_id": "prop_01j8rs605a4gctmbm58d87mvsj",
          "value": {
            "type": "text",
            "text_value": "Fall Gala"
          }
        }
      ],
      "artifacts": [
        {
          "name": "grant_letter.pdf",
          "file_id": "file_01j8rs605a4gctmbm58d87mvsj",
          "created_at": "2026-09-25T14:00:00Z"
        }
      ],
      "created_at": "2026-09-25T14:00:00Z",
      "updated_at": "2026-09-25T18:00:00Z",
      "canceled_at": null,
      "deleted_at": null,
      "merged_into_donation_id": null,
      "payment_status": "RECEIVED_IN_CHARIOT"
    }
  ]
}

Changes

  • 2026-10-01d2a4ff2fdda5Revision changes
    • info

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

    • info

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

  • 2026-10-015004365b29b6Revision changes
    • warning

      added the new UNKNOWN enum value to the /////// response property for the response status