---
title: "Get ACH Transfers"
method: GET
path: "/programs/{programCode}/accounts/{accountIdentifier}/ACHTransfers"
tags: ["Account"]
---

# Get ACH Transfers

`GET /programs/{programCode}/accounts/{accountIdentifier}/ACHTransfers`

This endpoint allows the retrieval of a list of transfers for an account. 

 Note: The maximum number of transfers in a list is 180 per request. 

 If the GET request is successful, the following response message will be returned along with a 200 HTTP status code. Filtering ACH Transfers ACH transfers can be filtered based on the following ACH Transfer Statuses, so specific ACH transfers can be viewed by the Partner. If GET /achTransfers is called and the status provided is one or more of the valid ACH Transfer Statuses (listed above), then the response will contain the ACH transfers within the selected (or defaulted) date range that have an ACH Transfer Status that matches one of the statuses that was provided in the call.

## Path parameters

- `programCode` string, required
- `accountIdentifier` string, required

## Query parameters

- `startDate` string
- `endDate` string
- `status` string

## Headers

- `X-GD-RequestId` string, required

## Response `200`

OK

- GetACHTransfersResponse — Represents the response containing a list of ACH (Automated Clearing House) transfers for an account.
  - `totalRecordCount` integer — The total number of ACH transfer records matching the request criteria.
  - `transfers` Transfer[], nullable — The list of ACH or account transfers for the account.
    - `achTransferType` string, nullable — The type of ACH transfer (e.g., "Credit", "Debit", "PPD", "CCD").
    - `transferIdentifier` string, nullable — The unique identifier for this transfer.
    - `accountIdentifier` string, nullable — The unique identifier of the account associated with the transfer.
    - `submissionDateTime` string, date-time — The date and time when the transfer was submitted.
    - `transactionAmount` number, double — The amount of the transaction.
    - `achTransferStatus` string, nullable — The current status of the ACH transfer (e.g., "Pending", "Completed", "Returned").
    - `returnDateTime` string, date-time, nullable — The date and time when the transfer was returned, if applicable.
    - `returnReasonCode` string, nullable — The reason code for a returned transfer, if applicable.
    - `returnStatus` string, nullable — The status of the returned transfer, if applicable.
    - `expectedDeliveryDate` string, date-time, nullable — The expected delivery date and time for the transfer, if available.
    - `bankAccountType` string, nullable — The type of bank account involved in the transfer (e.g., "Checking", "Savings").
    - `institutionName` string, nullable — The name of the financial institution associated with the bank account.
    - `last4BankAccountNumber` string, nullable — The last four digits of the bank account number involved in the transfer.
  - `responseDetails` ResponseDetail[], nullable — Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.
    - `code` integer — The primary status or error code for the response (e.g., 200 for success, 400 for validation error).
    - `subCode` integer, nullable — An optional subcode providing more granular detail about the response or error.
    - `description` string, nullable — A human-readable description of the response, error, or status.
    - `url` string, nullable — A URL linking to documentation or a web page with more information about the response code.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `500` — Internal Server Error
- `503` — Service Unavailable

---

[API](https://skmtc.net/greendot/apis/baas-apis.md) · [All operations](https://skmtc.net/greendot/apis/baas-apis/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/greendot/baas-apis/versions/666553766b78/schema)