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

# List funding activity

`GET /funding-activity`

Use this method to return a [paginated](https://docs.payroc.com/api/pagination) list of activity associated with your merchants' funding balances within a specific date range.  

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

Our gateway returns the following information about each activity in the list:
- Name of the merchant who owns the funding balance.
-	Amount of funds added or removed from the funding balance.
-	Funding account that received funds from the funding balance.

## Query parameters

- `before` string
- `after` string
- `limit` integer
- `dateFrom` string, date, required
- `dateTo` string, date, required
- `merchantId` string

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns a list of funding activity.

- FundingFundingActivityListResponse200 — 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` ActivityRecord[], required — Array of activityRecord objects.
    - `id` integer, required — Unique identifier that we assigned to the activity.
    - `date` string, datetime, required — Date that we moved the funds.
    - `merchant` string, required — Doing business as (DBA) name of the merchant that owns the funding balance.
    - `recipient` string — Name of the account holder who owns the funding account that received funds. **Note:** We return a value for recipient only if the value for type is `debit`.
    - `description` string, required — Description of the activity.
    - `amount` integer, required — Total amount that we removed or added to the merchant's funding balance. The value is in the currency’s lowest denomination, for example, cents.
    - `type` 'credit' | 'debit', required — Indicates if we moved funds into or out of the funding balance. Our gateway returns one of the following values: - `credit` - We moved funds into the funding balance. - `debit` - We moved funds out of the funding balance.
    - `currency` string, required — Currency of the funds. 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)