---
title: "List financial accounts"
method: GET
path: "/v1/financial_accounts"
tags: ["financial_accounts"]
---

# List financial accounts

`GET /v1/financial_accounts`

Returns a list of financial accounts.

## Query parameters

- `program_id` string
- `page_limit` integer
- `next_page_token` string

## Response `200`

The response for FinancialAccounts.list

- object
  - `results` FinancialAccount[]
    - `id` string, required — The unique identifier for the account
    - `account_type` 'disbursements' | 'processing' — The type of account. This field is deprecated and will be removed in a future version. Use the program_id field instead.
    - `program_id` string, required — The identifier for the program determining the capabilities of this financial account
    - `bank_provider` string, required — The bank provider for the account
    - `created_at` string, date-time, required — The date and time the account was created
    - `updated_at` string, date-time, required — The date and time the account was last updated
  - `next_page_token` 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 substituting the pageToken with this value). 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/specs.md) · [All operations](https://skmtc.net/chariot-giving/apis/specs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chariot-giving/specs/revisions/c194d399d515/schema)