Submit Grant Request

curl -X POST https://api.givechariot.com/v1/grant_requests/id/submit \
     -H "Authorization: Bearer <token>" \
     -H "Content-Type: application/json" \
     -d '{}'

{
  "id": "grant_req_01jpjenf5q6cawy43yxfcrxhct",
  "donor_account_id": "donor_account_01jpjenf5q6cawy43yxfcrxhct",
  "status": "submitted",
  "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-04T09:15: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": "string",
      "city": "Omaha",
      "state": "NE",
      "zip": "68131"
    }
  },
  "rejection_reason": "string"
}

Confirm that you have submitted the grant in your system.

Calling this endpoint moves the Grant Request’s status to submitted and emits a grant_request.updated webhook event.

The Grant Request must be in pending status. If the linked Donor Account is not yet approved, the Grant Request will be in awaiting_account_decision and this request returns status 412 Precondition Failed.
A Grant Request that is already submitted or rejected cannot be updated. Subsequent calls return status 409 Conflict.

Confirm that you have submitted the grant in your system. Calling this endpoint moves the Grant Request's status to `submitted` and emits a `grant_request.updated` webhook event. <Warning> - The Grant Request must be in `pending` status. If the linked [Donor Account](/api/donor-accounts) is not yet `approved`, the Grant Request will be in `awaiting_account_decision` and this request returns status `412 Precondition Failed`. - A Grant Request that is already `submitted` or `rejected` cannot be updated. Subsequent calls return status `409 Conflict`. </Warning>

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Path parameters

idstringRequired

The unique ID of the Grant Request.

Request

The request to submit a Grant Request. All fields are optional — an empty body is valid.

external_grant_idstringOptional

The DAF’s internal identifier for this grant. Setting this at submission time provides a useful audit trail and reconciliation key. Maximum length: 255 characters.

commentstringOptional

An optional comment recorded with the submission. Maximum length: 400 characters.

Response

The Grant Request was submitted.

idstringRead-only

The unique identifier for this Grant Request.

donor_account_idstring

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

statusenum

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:

einstring

The EIN of the recipient nonprofit.

amount_centslong

The grant amount in cents (USD).

frequencyenum

How often the donor intends this grant to recur. Only frequencies enabled in your DAF Provider settings will appear on Grant Requests.

Allowed values:

form_urlstringformat: "uri"

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

created_atstringRead-onlyformat: "date-time"

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

updated_atstringRead-onlyformat: "date-time"

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

giving_pool_idstring or null

The ID of the Giving Pool the grant is being made from. Present when the donor selected a specific giving pool.

nonprofit_namestring

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

purposestring or null

The donor's stated purpose for the grant.

notestring or null

An optional note from the donor to the nonprofit.

donor_contactobject

A snapshot of the donor's contact information captured for this Grant Request.

rejection_reasonstring or null

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

Errors

400

Bad Request Error

401

Unauthorized Error

403

Forbidden Error

404

Not Found Error

409

Conflict Error

412

Precondition Failed Error

500

Internal Server Error