v39

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

Donor Accounts

List Donor Accounts

Returns a list of Donor Accounts for the authenticated DAF. This endpoint supports cursor-based pagination as well as filtering by fund, status, and email.

get/v1/donor_accounts

Query parameters

giving_pool_idstring

The id of a Giving Pool. When set, filters Donor Accounts to those that have this Giving Pool associated with them.

status'pending' | 'approved' | 'rejected'

The status of a Donor Account.

pending: The Donor Account has been created but the DAF has not yet approved or rejected it.
approved: The DAF has verified the donor's identity and Grants from this account can be processed.
rejected: The DAF has rejected the Donor Account. Grants from this account will not be processed.

Example:pending

Filter Donor Accounts to only those with the specified status.

emailstring

Filter Donor Accounts by donor email. The match is case insensitive and exact.

external_idstring

Filter Donor Accounts by external_id — the DAF's internal identifier for the Donor Account.

page_limitinteger

the number of results to return; defaults to 10, max is 100

page_tokenstring

A token to use to retrieve the next page of results. This is useful for paginating over many pages of results. If set, all other arguments are expected to be kept the same as previous calls and the value of this field should be from the next_page_token in the previous response.

Response

The response for DonorAccounts.list

next_page_tokenstring nullable

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 page_token). 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": "donor_account_01jpjenf5q6cawy43yxfcrxhct",
      "status": "pending",
      "donor": {
        "email": "warrenBuffet@example.com",
        "first_name": "Warren",
        "last_name": "Buffet",
        "phone": "+12125550100"
      },
      "external_id": "ACME-DAF-DONOR-1042",
      "approval": {
        "approved_at": "2026-04-02T18:30:00Z",
        "approved_by": "daf:fid_01jpjenf5q6cawy43yxfcrxhct"
      },
      "rejection": {
        "rejected_at": "2026-04-02T18:30:00Z",
        "rejected_by": "daf:fid_01jpjenf5q6cawy43yxfcrxhct",
        "rejection_reason": "Donor could not be located in our records."
      },
      "created_at": "2026-04-01T12:00:00Z",
      "updated_at": "2026-04-02T18:30:00Z"
    }
  ]
}