---
title: "List funding accounts"
method: GET
path: "/funding-accounts"
tags: ["fundingAccounts"]
---

# List funding accounts

`GET /funding-accounts`

Use this method to return a [paginated](https://docs.payroc.com/api/pagination) list of funding accounts associated with your account.  

**Note:** If you want to view the details of a specific funding account and you have its fundingAccountId, use our [Retrieve Funding Account](https://docs.payroc.com/api/schema/funding/funding-accounts/retrieve) method.  

Our gateway returns the following information about each funding account in the list:  
- Name of the account holder and ACH details for the account.  
- Status of the account.  
- Whether we send funds to the account, withdraw funds from the account, or both.  

For each funding account, we also return the fundingAccountId, which you can use to perform follow-on actions.

## Query parameters

- `before` string
- `after` string
- `limit` integer

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns a paginated list of all funding accounts.

- ListFundingAccounts — Contains the pagination properties that you use to navigate through a list of results.
  - `limit` integer — Maximum number of results that we return for each page.
  - `count` integer — Number of results we returned on this page. **Note:** This might not be the total number of results that match your query.
  - `hasMore` boolean — Indicates whether there is another page of results available.
  - `links` Link[] — Reference links to navigate to the previous page of results or to the next page of results.
    - `rel` string, required — Indicates the relationship between the current resource and the target resource.
    - `method` string, required — HTTP method that you need to use with the target resource.
    - `href` string, required — URL of the target resource.
  - `data` FundingAccount[], required — Array of fundingAccount objects.
    - `fundingAccountId` integer — Unique identifier that we assigned to the funding account.
    - `createdDate` string, date-time — Date and time that we received your request to create the funding account in our system.
    - `lastModifiedDate` string, date-time — Date and time that the funding account was last modified.
    - `status` 'approved' | 'rejected' | 'pending' | 'hold' — Status of the funding account. The value is one of the following: - `approved` - We approved the funding account. - `rejected` - We rejected the funding account. - `pending` - We have not yet approved the funding account. - `hold` - Our Risk team have temporarily placed a hold on the funding account.
    - `type` 'checking' | 'savings' | 'generalLedger', required — Type of funding account.
    - `use` 'credit' | 'debit' | 'creditAndDebit', required — Indicates if we send funds or withdraw funds from the account. - `credit` - Send funds to the account. - `debit` - Withdraw funds from the account. - `creditAndDebit` - Send funds and withdraw funds from the account. **Note:** If the funding account is associated with a funding recipient, we accept only a value of `credit`.
    - `nameOnAccount` string, required — Name of the account holder.
    - `paymentMethods` PaymentMethodsItems[], required — Array of PaymentMethodAch objects.
      - `type` 'ach', required — Discriminator value: ach
      - `value` PaymentMethodsItemsDiscriminatorMappingAchValue — Object that contains information about the funding account.
        - `routingNumber` string, required — Routing number of the funding account.
        - `accountNumber` string, required — Account number of the funding account.
    - `metadata` object — [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
    - `links` Link[] — Array of HATEOAS links.
      - `rel` string, required — Indicates the relationship between the current resource and the target resource.
      - `method` string, required — HTTP method that you need to use with the target resource.
      - `href` string, required — URL of the target resource.

## Other responses

- `400` — Invalid request
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)