---
title: "List Recurring Grants"
method: GET
path: "/v1/recurring_grants"
tags: ["recurring_grants"]
---

# List Recurring Grants

`GET /v1/recurring_grants`

Returns a list of all recurring grants for a given Connect. This API allows for paginating over many results.

## Query parameters

- `connect_id` string
- `pageLimit` integer
- `pageToken` string

## Response `200`

The response for RecurringGrants.list

- object
  - `results` RecurringGrant[]
    - `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.
  - `nextPageToken` string — A cursor token to use to retrieve the next page of results by making another API call to the same endpoint with the same parameters (only changing the pageToken). If specified, then more results exist on the server that were not returned, otherwise no more results exist on the server.

## 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
- `500` — Internal Server Error

---

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