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

# Get Recurring Grant

`GET /v1/recurring_grants/{id}`

## Request

- Base URL: `https://sandboxapi.givechariot.com`
- URL: `https://sandboxapi.givechariot.com/v1/recurring_grants/{id}`
- Auth: HTTP bearer

Retrieve a recurring grant with a given ID.

## Path parameters

- `id` string, uuid, required

## Response `200`

OK

- RecurringGrant: A RecurringGrant represents a successfully initiated recurring grant request with a Donor Advised Fund. RecurringGrants are created when a person interacts with an instance of Chariot Connect and successfully submits a recurring grant and completes the workflow. On creation, each RecurringGrant object will also have a Grant object created to represent the first grant of the recurring grant. There can be many grants associated with the same recurring grant.
  - `id` string, uuid, required: The unique identifier for the object
  - `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
  - `frequency` 'MONTHLY', required: How often the DAF provider will submit the recurring grant. At the moment, monthly is the only supported frequency.
  - `externalRecurringGrantId` 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
  - `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
  - `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.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)