---
title: "List Grant Requests"
method: GET
path: "/v1/grant_requests"
tags: ["Grant Requests"]
---

# List Grant Requests

`GET /v1/grant_requests`

Returns a list of Grant Requests accessible to the authenticated DAF account.

Use `donor_account_id` to retrieve all Grant Requests associated with a specific donor.

## Query parameters

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

## Response `200`

OK

- object
  - `results` GrantRequest[]
    - `id` string, required — The unique identifier for this Grant Request.
    - `donor_account_id` string, required — The ID of the [Donor Account](/api/donor-accounts) this Grant Request belongs to.
    - `giving_pool_id` string, nullable — The ID of the [Giving Pool](/api/giving_pools) the grant is being made from. Present when the donor selected a specific giving pool.
    - `status` 'awaiting_account_decision' | 'pending' | 'submitted' | 'rejected', required — The lifecycle status of a Grant Request. - `awaiting_account_decision`: The linked Donor Account is not yet `approved`. Advances automatically when the account is approved. - `pending`: The Donor Account is approved and the Grant Request is awaiting your decision. - `submitted`: You have submitted the grant in your system. Terminal. - `rejected`: You have rejected the grant and it will not be processed. Terminal.
    - `ein` string, required — The EIN of the recipient nonprofit.
    - `nonprofit_name` string — The name of the recipient nonprofit at the time of the Grant Request.
    - `amount_cents` integer, required — The grant amount in cents (USD).
    - `frequency` 'one_time' | 'monthly' | 'quarterly' | 'annual', required — How often the donor intends this grant to recur. Only frequencies enabled in your DAF Provider settings will appear on Grant Requests.
    - `form_url` string, uri, required — The URL of the page where the donor submitted the DAFpay gift.
    - `purpose` string, nullable — The donor's stated purpose for the grant.
    - `note` string, nullable — An optional note from the donor to the nonprofit.
    - `donor_contact` GrantRequestDonorContact — A snapshot of the donor's contact information captured for this Grant Request.
      - `name` string
      - `email` string, email
      - `phone` string
      - `address` GrantRequestDonorContactAddress — The donor's mailing address at the time of the Grant Request.
        - `line1` string
        - `line2` string, nullable
        - `city` string
        - `state` string
        - `zip` string
    - `rejection_reason` string, nullable — The reason provided when the Grant Request was rejected. Set when status transitions to `rejected`.
    - `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.
  - `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/chariot-api.md) · [All operations](https://skmtc.net/chariot-giving/apis/chariot-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/chariot-api/versions/dc28cadc066e/schema)