---
title: "List Giving Pools"
method: GET
path: "/v1/giving_pools"
tags: ["Giving Pools"]
---

# List Giving Pools

`GET /v1/giving_pools`

Returns a list of Giving Pools accessible to the authenticated DAF account.

Giving Pools represent individual named giving pools within a donor's DAF account (e.g. "Smith Family Fund").
A [Donor Account](/api/donor-accounts) may be associated with multiple Giving Pools.

## Query parameters

- `donor_account_id` string
- `page_limit` integer
- `page_token` string

## Response `200`

OK

- object
  - `results` GivingPool[]
    - `id` string, uuid, required — The unique identifier for this Giving Pool.
    - `name` string, required — The display name of the Giving Pool. This is the name that the Donor will see when they are selecting a Giving Pool in DAFpay.
    - `donor_account_id` string, required — The ID of the [Donor Account](/api/donor-accounts) this Giving Pool belongs to.
    - `created_at` string, date-time, required — Time when this object was created, expressed in RFC 3339 format.
    - `updated_at` string, date-time, required — Time when this object was last updated, expressed in RFC 3339 format.
    - `metadata` object — A map of arbitrary string keys and values to store information about the object.
  - `next_page_token` string — A token to retrieve the next page of results. Absent when there are no more results.

## Other responses

- `400` — The request is invalid or contains invalid parameters
- `401` — Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller.
- `403` — Access denied
- `500` — Internal Server Error

---

[API](https://skmtc.net/chariot-giving/apis/specs.md) · [All operations](https://skmtc.net/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/specs/revisions/8446023e02fb/schema)