> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.givechariot.com/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.givechariot.com/_mcp/server. # List Grant Requests GET https://api.givechariot.com/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. Reference: https://docs.givechariot.com/api/grant-requests/list ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Servers - `https://api.givechariot.com` (Production, default) - `https://sandboxapi.givechariot.com` (Sandbox) ## Request ### Query parameters - `donor_account_id` (string, optional) — Filter Grant Requests by the ID of the associated [Donor Account](/api/donor-accounts). - `page_limit` (integer, optional, default: 10) — The number of results to return. Defaults to 10, max is 100. - `page_token` (string, optional) — A token to retrieve the next page of results. ## Response ### 200 OK - `results` (list of GrantRequest, optional) - `next_page_token` (string, optional) — A token to retrieve the next page of results. Absent when there are no more results. ## Errors ### 400 Bad Request Error The request is invalid or contains invalid parameters - `type` (string, required) — A URI reference identifying the problem type. - `title` (string, required) — A short, human-readable summary of the problem type. - `status` (integer, required) — The HTTP status code for this error. - `detail` (string, required) — A human-readable explanation specific to this occurrence. ### 401 Unauthorized Error Unauthorized. The request is missing the security (OAuth2 Bearer token) requirements and the server is unable to verify the identify of the caller. - `type` (string, required) — A URI reference identifying the problem type. - `title` (string, required) — A short, human-readable summary of the problem type. - `status` (integer, required) — The HTTP status code for this error. - `detail` (string, required) — A human-readable explanation specific to this occurrence. ### 403 Forbidden Error Access denied - `type` (string, required) — A URI reference identifying the problem type. - `title` (string, required) — A short, human-readable summary of the problem type. - `status` (integer, required) — The HTTP status code for this error. - `detail` (string, required) — A human-readable explanation specific to this occurrence. ### 500 Internal Server Error Internal Server Error - `type` (string, required) — A URI reference identifying the problem type. - `title` (string, required) — A short, human-readable summary of the problem type. - `status` (integer, required) — The HTTP status code for this error. - `detail` (string, required) — A human-readable explanation specific to this occurrence. ## Types ### GrantRequest A Grant Request is a donation intent submitted by a donor through the DAFpay payment option, addressed to a specific nonprofit. The DAF Provider is responsible for processing it in their own system and reporting the outcome back to DAFpay via the [Submit](/api/grant-requests/submit) or [Reject](/api/grant-requests/reject) endpoints. All amounts are in US dollars. - `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. - `status` (enum, 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. - Allowed values: `awaiting_account_decision`, `pending`, `submitted`, `rejected` - `ein` (string, required) — The EIN of the recipient nonprofit. - `amount_cents` (long, required) — The grant amount in cents (USD). - `frequency` (enum, required) — How often the donor intends this grant to recur. Only frequencies enabled in your DAF Provider settings will appear on Grant Requests. - Allowed values: `one_time`, `monthly`, `quarterly`, `annual` - `form_url` (string, required) — The URL of the page where the donor submitted the DAFpay gift. - `created_at` (datetime, required) — Time when this object was created, expressed in RFC 3339 format. - `updated_at` (datetime, required) — Time when this object was last updated, expressed in RFC 3339 format. - `giving_pool_id` (string, optional, 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. - `nonprofit_name` (string, optional) — The name of the recipient nonprofit at the time of the Grant Request. - `purpose` (string, optional, nullable) — The donor's stated purpose for the grant. - `note` (string, optional, nullable) — An optional note from the donor to the nonprofit. - `donor_contact` (GrantRequestDonorContact, optional) — A snapshot of the donor's contact information captured for this Grant Request. - `rejection_reason` (string, optional, nullable) — The reason provided when the Grant Request was rejected. Set when status transitions to `rejected`. ### GrantRequestDonorContact A snapshot of the donor's contact information captured for this Grant Request. - `name` (string, optional) - `email` (string, optional) - `phone` (string, optional) - `address` (GrantRequestDonorContactAddress, optional) — The donor's mailing address at the time of the Grant Request. ### GrantRequestDonorContactAddress The donor's mailing address at the time of the Grant Request. - `line1` (string, optional) - `line2` (string, optional, nullable) - `city` (string, optional) - `state` (string, optional) - `zip` (string, optional) ## Examples **Response** ```json { "results": [ { "id": "grant_req_01jpjenf5q6cawy43yxfcrxhct", "donor_account_id": "donor_account_01jpjenf5q6cawy43yxfcrxhct", "status": "pending", "ein": "53-0196605", "amount_cents": 10000, "frequency": "one_time", "form_url": "https://example.org/donate", "created_at": "2026-04-03T14:22:00Z", "updated_at": "2026-04-03T14:22:00Z", "giving_pool_id": "0bf40881-8ee2-47fb-98ca-f58c7999aa34", "nonprofit_name": "American Red Cross", "purpose": "Disaster relief", "note": "Thank you for your service.", "donor_contact": { "name": "Warren Buffet", "email": "warrenBuffet@example.com", "phone": "+12125550100", "address": { "line1": "3555 Farnam Street", "line2": null, "city": "Omaha", "state": "NE", "zip": "68131" } }, "rejection_reason": null }, { "id": "grant_req_01jpjenf5q6cawy43yxfcrxhcu", "donor_account_id": "donor_account_01jpjenf5q6cawy43yxfcrxhct", "status": "submitted", "ein": "13-1635294", "amount_cents": 25000, "frequency": "one_time", "form_url": "https://example.org/donate", "created_at": "2026-03-28T10:05:00Z", "updated_at": "2026-03-29T08:00:00Z", "giving_pool_id": "0bf40881-8ee2-47fb-98ca-f58c7999aa34", "nonprofit_name": "World Wildlife Fund", "purpose": null, "note": null, "donor_contact": { "name": "Warren Buffet", "email": "warrenBuffet@example.com", "phone": "+12125550100", "address": { "line1": "3555 Farnam Street", "line2": null, "city": "Omaha", "state": "NE", "zip": "68131" } }, "rejection_reason": null }, { "id": "grant_req_01jpjenf5q6cawy43yxfcrxhcv", "donor_account_id": "donor_account_01jpjenf5q6cawy43yxfcrxhct", "status": "rejected", "ein": "13-1788491", "amount_cents": 500000, "frequency": "one_time", "form_url": "https://example.org/donate", "created_at": "2026-03-20T16:11:00Z", "updated_at": "2026-03-21T09:30:00Z", "giving_pool_id": "0bf40881-8ee2-47fb-98ca-f58c7999aa34", "nonprofit_name": "Doctors Without Borders", "purpose": null, "note": null, "donor_contact": { "name": "Warren Buffet", "email": "warrenBuffet@example.com", "phone": "+12125550100", "address": { "line1": "3555 Farnam Street", "line2": null, "city": "Omaha", "state": "NE", "zip": "68131" } }, "rejection_reason": "Grant amount exceeds donor's available balance." } ], "next_page_token": "c3f685f2-2dda-4956-815b-39867a5e5638" } ```