---
title: "List funding instructions"
method: GET
path: "/funding-instructions"
tags: ["fundingInstructions"]
---

# List funding instructions

`GET /funding-instructions`

> Important: You can return a list of funding instructions from only the previous two years. If you want to view a funding instruction from more than two years ago and you have its instructionId, use our [Retrieve Funding Instruction](https://docs.payroc.com/api/schema/funding/funding-instructions/retrieve) method.  

Use this method to return a [paginated](https://docs.payroc.com/api/pagination) list of funding instructions within a specific date range.  

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

Our gateway returns the following information for each instruction in the list:  
-	Status of the funding instruction.  
-	Funding information, including which merchant's funding balance we distribute and the funding account that we send the balance to.  

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

## Query parameters

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

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns a list of funding instructions.

- FundingFundingInstructionsListResponse200 — 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` FundingInstructionsGetResponsesContentApplicationJsonSchemaDataItems[], required — Array of fundingInstruction objects.
    - `instructionId` integer — Unique identifier that we assigned to the funding instruction.
    - `createdDate` string, datetime — Date that we created the funding instruction. The date format follows the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) standard.
    - `lastModifiedDate` string, datetime — Date of the most recent change to the funding instruction. The date format follows the [ISO 8601](https://www.iso.org/iso-8601-date-and-time-format.html) standard.
    - `status` 'accepted' | 'pending' | 'completed' — Status of the funding instruction. Our gateway returns one of the following values: - `accepted` - We have received the funding instruction but have not yet reviewed it. - `pending` - We have received the funding instruction and we are reviewing it. - `completed` - We have reviewed and processed the funding instruction.
    - `merchants` FundingInstructionsGetResponsesContentApplicationJsonSchemaDataItemsMerchantsItems[] — Array of merchants objects. Each object specifies the merchant whose funding balance we distribute and who you want to send the funds to.
      - `merchantId` string, required — Unique identifier that the processor assigned to the merchant.
      - `recipients` FundingInstructionsGetResponsesContentApplicationJsonSchemaDataItemsMerchantsItemsRecipientsItems[], required — Array of recipients objects. Each object contains information about the funding account and the amount of funds we send to the funding account.
        - `fundingAccountId` integer, required — Unique identifier that we assigned to the funding account.
        - `paymentMethod` 'ACH', required — Payment method that we use to send funds to the funding account.
        - `amount` FundingInstructionsGetResponsesContentApplicationJsonSchemaDataItemsMerchantsItemsRecipientsItemsAmount, required — Object that contains information about the funds that we send to the funding account.
          - `value` integer, required — Amount of funds in the currency's lowest denomination, for example, cents.
          - `currency` 'USD' — Currency of the value parameter.
        - `status` 'accepted' | 'pending' | 'released' | 'funded' | 'failed' | 'rejected' | 'onHold' — Status of the individual payment instruction. Our gateway returns one of the following values: - `accepted` - We received the payment instruction, but we haven't reviewed it. - `pending` - We are reviewing the payment instruction. - `released` - We approved the payment instruction. - `funded` - We sent the funds to the funding account by ACH. - `failed` - The ACH payment to the funding account failed. - `rejected` - We reviewed the payment instruction and rejected it. - `onHold` - We have placed the payment instruction on hold.
        - `metadata` object — [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
        - `link` FundingInstructionsGetResponsesContentApplicationJsonSchemaDataItemsMerchantsItemsRecipientsItemsLink — Object that contains HATEOAS links for the resource.
          - `rel` string — Indicates the relationship between the current resource and the target resource.
          - `method` string — HTTP method that you need to use with the target resource.
          - `href` string — URL of the target resource.
      - `link` FundingInstructionsGetResponsesContentApplicationJsonSchemaDataItemsMerchantsItemsLink — Object that contains HATEOAS links for the resource.
        - `rel` string — Indicates the relationship between the current resource and the target resource.
        - `method` string — HTTP method that you need to use with the target resource.
        - `href` string — URL of the target resource.
    - `metadata` object — [Metadata](https://docs.payroc.com/api/metadata) object you can use to include custom data with your request.
    - `link` Link — Object that contains HATEOAS links for the resource.
      - `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` — 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)