v39

latestOpenAPI 3.0.0raw.githubusercontent.com2026-08-017897360.9 KB
donations

List Donations

List donations for your account.

get/v1/donations

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.

payment_source_idstring

The unique identifier for the payment sources to filter donations by. 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": "29247869",
      "payment_source_id": "payment_source_01kew60ks7w0epkvp2bgqxrt8z",
      "currency": "USD",
      "purpose": "Where needed most",
      "note": "Please dedicate in memory of grandma",
      "attribution": {
        "primary_donor": {
          "full_name": "John Doe",
          "first_name": "John",
          "last_name": "Doe",
          "email": "bob@me.com",
          "phone": "415-555-1212",
          "address": {
            "city": "New York",
            "country": "US",
            "line1": "123 Main St.",
            "postal_code": "12345",
            "state": "NY"
          }
        },
        "joint_donor": {
          "full_name": "John Doe",
          "first_name": "John",
          "last_name": "Doe",
          "email": "bob@me.com",
          "phone": "415-555-1212",
          "address": {
            "city": "New York",
            "country": "US",
            "line1": "123 Main St.",
            "postal_code": "12345",
            "state": "NY"
          }
        }
      },
      "initiation": {
        "initiated_at": "2020-01-31T23:59:59Z",
        "channel": "INTEGRATED",
        "web_location_url": "https://www.example.com/donation/1234567890",
        "fundraising_platform_name": "Classy",
        "dafpay_form": "DAF day",
        "dafpay_tracking_id": "L9E182VBGP",
        "dafpay_metadata": {
          "funding_source": "DAF",
          "funding_source_id": "daf_01j8rs605a4gctmbm58d87mvsj",
          "funding_source_name": "DAF day"
        },
        "frequency": "ONE_TIME"
      },
      "settlement": {
        "deposit_id": "deposit_01kewb5vgsryzaajza5ynr06kz",
        "received_at": "2020-01-31T23:59:59Z",
        "settled_at": "2020-01-31T23:59:59Z"
      },
      "donor_advised_fund_grant": {
        "organization_name": "Daffy Charitable Fund",
        "donor_fund_name": "The Smith Family Fund",
        "sponsor_grant_id": "93492947-7894-4663-a944-f2469d0027ca"
      },
      "platform": {
        "name": "PayPal Grant Payments",
        "platform_grant_id": "93492947-7894-4663-a944-f2469d0027ca",
        "acceptance": {
          "accepted": true,
          "expires_at": "2020-01-31T23:59:59Z"
        }
      },
      "corporate_match": {
        "company_name": "Google",
        "program_name": "Google Matching Grant Program",
        "source": "Payroll"
      },
      "properties": [
        {
          "property_id": "prop_01j8rs605a4gctmbm58d87mvsj",
          "value": {
            "type": "text"
          }
        }
      ],
      "artifacts": [
        {
          "id": "artifact_01j8rs605a4gctmbm58d87mvsj",
          "name": "donation_receipt.pdf",
          "file_id": "file_01j8rs605a4gctmbm58d87mvsj",
          "created_at": "2020-01-31T23:59:59Z"
        }
      ],
      "created_at": "2020-01-31T23:59:59Z",
      "updated_at": "2020-01-31T23:59:59Z",
      "canceled_at": "2020-01-31T23:59:59Z",
      "payment_status": "INCOMING_TO_CHARIOT"
    }
  ]
}