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

# List Grant Requests

`GET /v1/grant_requests`

## Request

- Base URL: `https://sandboxapi.givechariot.com`
- URL: `https://sandboxapi.givechariot.com/v1/grant_requests`
- Auth: HTTP bearer

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.dev/chariot-giving/apis/chariot-api-5.md) - [All operations](https://skmtc.dev/chariot-giving/apis/chariot-api-5/llms.txt) - [OpenAPI document](https://skmtc.dev/chariot-giving/apis/chariot-api-5/revisions/d2a4ff2fdda5?raw)