---
title: "Get Grant"
method: GET
path: "/v1/grants/{id}"
tags: ["Grants"]
---

# Get Grant

`GET /v1/grants/{id}`

Retrieve a grant with the given ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- Grant — A Grant represents a successfully initiated grant request with a Donor Advised Fund. Grants are created when a person interacts with an instance of Chariot Connect and successfully submits a grant and completes the workflow. There can be many grants associated with a Connect object and therefore a nonprofit.
  - `id` string, uuid, required — The unique identifier for the object
  - `userFriendlyId` string — Often referred to as the "Chariot ID", this is the ID that will be included in the payment from the DAF provider.
  - `trackingId` string — The tracking ID for the grant
  - `workflowSessionId` string, uuid, required — ID of the Connect Workflow Session associated with this grant
  - `fundId` string, required — ID of the donor advised fund
  - `externalGrantId` string — ID of the grant associated with the donor advised fund
  - `createdAt` string, date-time — Time when this object was created; expressed in RFC 3339 format
  - `updatedAt` string, date-time — Time when this object was last updated; expressed in RFC 3339 format
  - `amount` number, required — The grant amount expressed in units of whole cents
  - `status` string — The status of the grant
  - `feeDetail` object — The fee detail of the grant
    - `total` number — The total fee amount expressed in units of cents
    - `contributions` ContributionFeeDetail[] — The list of fee contributions for this grant
      - `name` string, required — The name of the party charging the fee. This is an informational field. If you need to differentiate between fees charged by different parties, you should use the `feeType` field.
      - `amount` number, required — The fee contribution amount expressed in units of cents
      - `feeType` 'chariot' | 'daf' | 'fundraising_application' — This indicates the source of a fee contribution. * chariot: Chariot's processing fee * daf: The DAF's processing fee * fundraising_application: The fundraising application's processing fee
  - `metadata` object — A map of arbitrary string keys and values to store information about the object
  - `firstName` string — The donor's first name
  - `lastName` string — The donor's last name
  - `phone` string — The donor's phone number
  - `email` string — The donor's email
  - `note` string — An note inputted by the user at submisson
  - `statuses` GrantStatus[] — The list of grant statuses for this grant
    - `id` string, uuid, required — The unique identifier for the object
    - `createdAt` string, date-time, required — Time when this object was created; expressed in RFC 3339 format
    - `status` 'Initiated' | 'Completed' | 'Canceled', required — The status of the grant.
    - `comment` string — The user comment for the update
  - `paymentChannel` 'dafpay_network' | 'direct' — The payment channel for the grant. This is useful to know how the grant will be sent. The payment channel will be one of the following: - dafpay_network: Grant will be sent to the DAFPay Network 501(c)(3) nonprofit organization (EIN: 93-1372175). The DAFPay Network will then review and process the grant and send the funds to the intended recipient. - direct: Grant will be sent directly to the intended recipient.
  - `address` GrantAddress
    - `line1` string — Address line 1 (e.g. street, PO Box, or company name). Maximum length: 255 characters.
    - `line2` string — Address line 2 (e.g. apartment, suite, unit, or building). Maximum length: 255 characters.
    - `city` string — City, district, suburb, town, or village.. Maximum length: 255 characters.
    - `state` string — State, county, province, or region. Maximum length: 255 characters.
    - `postalCode` string — ZIP or postal code. Maximum length: 255 characters.

## 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
- `404` — Resource Not Found
- `500` — Internal Server Error

---

[API](https://skmtc.net/chariot-giving/apis/chariot-api-4.md) · [All operations](https://skmtc.net/chariot-giving/apis/chariot-api-4/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/chariot-api-4/versions/c194d399d515/schema)