---
title: "List funding balances"
method: GET
path: "/funding-balance"
tags: ["fundingActivity"]
---

# List funding balances

`GET /funding-balance`

Use this method to return a [paginated](https://docs.payroc.com/api/pagination) list of funding balances available for each merchant linked to your account.  

Use query parameters to filter the list of results we return, for example, to search for the funding balance for a specific merchant.  

Our gateway returns the following information about each merchant in the list:  
- Total funds for the merchant.  
- Available funds that you can use for funding instructions.  
- Pending funds that we have not yet sent to funding accounts.

## Query parameters

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

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns the funding balance available for each merchant.

- FundingFundingActivityRetrieveBalanceResponse200 — 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` MerchantBalance[], required — Array of merchantBalance objects.
    - `merchantId` string — Unique identifier that the processor assigned to the merchant.
    - `funds` integer — Total funding balance for the merchant, including pending amounts. The value is in the currency's lowest denomination, for example, cents.
    - `pending` integer — Amount of the funding balance that we have not yet sent to funding accounts. The value is in the currency's lowest denomination, for example, cents.
    - `available` integer — Amount of the funding balance that you can use in funding instructions. The value is in the currency's lowest denomination, for example, cents.
    - `currency` string — Currency of the funding balance. We return a value of `USD`.

## Other responses

- `400` — Validation error.
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `406` — Not acceptable
- `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)