Grant Requests

Reject Grant Request

Indicate that you will not process this grant.

Calling this endpoint moves the Grant Request's status to rejected and emits a grant_request.updated webhook event. The Donor Account itself is unaffected; future Grant Requests from the same donor can still be processed.

<Warning> A Grant Request that is already `submitted` or `rejected` cannot be updated. Subsequent calls return status `409 Conflict`. </Warning>

post/v1/grant_requests/{id}/reject

Path parameters

idstring required

The unique ID of the Grant Request.

Request body

reasonstring

A human-readable reason for the rejection. Maximum length: 400 characters.

Example request

{
  "reason": "Grant amount exceeds donor's available balance."
}

Response

The Grant Request was rejected.

idstring required

The unique identifier for this Grant Request.

donor_account_idstring required

The ID of the Donor Account this Grant Request belongs to.

giving_pool_idstring nullable

The ID of the Giving Pool 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.

einstring required

The EIN of the recipient nonprofit.

nonprofit_namestring

The name of the recipient nonprofit at the time of the Grant Request.

amount_centsinteger 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_urlstring uri required

The URL of the page where the donor submitted the DAFpay gift.

purposestring nullable

The donor's stated purpose for the grant.

notestring nullable

An optional note from the donor to the nonprofit.

rejection_reasonstring nullable

The reason provided when the Grant Request was rejected. Set when status transitions to rejected.

created_atstring date-time required

Time when this object was created, expressed in RFC 3339 format.

updated_atstring date-time required

Time when this object was last updated, expressed in RFC 3339 format.

Example response

{
  "id": "grant_req_01jpjenf5q6cawy43yxfcrxhct",
  "donor_account_id": "donor_account_01jpjenf5q6cawy43yxfcrxhct",
  "giving_pool_id": "0bf40881-8ee2-47fb-98ca-f58c7999aa34",
  "ein": "12-3456789",
  "nonprofit_name": "American Red Cross",
  "amount_cents": 10000,
  "form_url": "https://example.org/donate",
  "created_at": "2026-04-01T09:00:00Z",
  "updated_at": "2026-04-01T12:00:00Z"
}

Changes

Changed in 7 of the 43 revisions of this API.351160

Jun 29, 2026b87f7738d3361230See the full diff
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ○
  media type application/json was changed to a more specific media type application/problem+json for the response status
  response-media-type-name-specialized
- ○
  media type application/json was changed to a more specific media type application/problem+json for the response status
  response-media-type-name-specialized
- ○
  media type application/json was changed to a more specific media type application/problem+json for the response status
  response-media-type-name-specialized
- ○
  media type application/json was changed to a more specific media type application/problem+json for the response status
  response-media-type-name-specialized
- ○
  media type application/json was changed to a more specific media type application/problem+json for the response status
  response-media-type-name-specialized
- ○
  media type application/json was changed to a more specific media type application/problem+json for the response status
  response-media-type-name-specialized
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
Jun 29, 2026c65f43c5ad906See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
Jun 25, 2026f89b4f376e9418See the full diff
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
- ○
  added the optional property // to the response with the status
  response-optional-property-added
Jun 25, 202690671617b825186See the full diff
- ▲
  the response's property type changed from number to string for status
  response-property-type-changed
- ▲
  the response's property type changed from number to string for status
  response-property-type-changed
- ▲
  the response's property type changed from number to string for status
  response-property-type-changed
- ▲
  the response's property type changed from number to string for status
  response-property-type-changed
- ▲
  the response's property type changed from number to string for status
  response-property-type-changed
- ▲
  the response's property type changed from number to string for status
  response-property-type-changed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ▲
  removed the required property from the response with the status
  response-required-property-removed
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog
May 18, 20264f143792edeb55See the full diff
- ●
  removed the optional property from the response with the status
  response-optional-property-removed
- ●
  added the new awaiting_account_decision enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new pending enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new rejected enum value to the response property for the response status
  response-property-enum-value-added
- ●
  added the new submitted enum value to the response property for the response status
  response-property-enum-value-added
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  removed the awaiting_account_approval enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the awaiting_daf_submission enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the canceled enum value from the response property for the response status
  response-property-enum-value-removed
- ○
  removed the initiated enum value from the response property for the response status
  response-property-enum-value-removed
May 17, 2026744e71a357955See the full diff
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property // became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
- ▲
  the response property became nullable for the status
  response-property-became-nullable
May 17, 20260d7f8b96202a1See the full diff
- ○
  endpoint added
  endpoint-added
This revision also has 1 change that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history