---
updatedAt: 2026-02-06T00:24:43.000Z
agentTools:
  projectIndex: https://developer.greendot.com/embedded-finance/llms.txt
---

# Get ACH Transfers

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.

# OpenAPI definition

```json
{
  "openapi": "3.0.1",
  "info": {
    "title": "BaaS APIs",
    "description": "Green Dot BaaS Partner API",
    "version": "v1",
    "x-generated-timestamp-utc": "2026-02-05T01:14:54.4774970Z"
  },
  "paths": {
    "/programs/{programCode}/accounts/{accountIdentifier}/ACHTransfers": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "Get ACH Transfers",
        "description": "This endpoint allows the retrieval of a list of transfers for an account. \r\n\r\n Note: The maximum number of transfers in a list is 180 per request. \r\n\r\n 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.",
        "operationId": "Account_GET_GetACHTransfer",
        "parameters": [
          {
            "name": "programCode",
            "in": "path",
            "description": "Partner program code for the account.",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "accountIdentifier",
            "in": "path",
            "description": "Unique account identifier (UID or GUID).",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "startDate",
            "in": "query",
            "description": "Start date for filtering transfers (yyyy-MM-dd).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "endDate",
            "in": "query",
            "description": "End date for filtering transfers (yyyy-MM-dd).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "description": "Comma-separated list of ACH transfer statuses (see ACHTransferStatus enum).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "X-GD-RequestId",
            "in": "header",
            "description": "Unique request tracking identifier (X-GD-RequestId header).",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              }
            }
          },
          "401": {
            "description": "Unauthorized"
          },
          "403": {
            "description": "Forbidden",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              }
            }
          },
          "500": {
            "description": "Internal Server Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              }
            }
          },
          "503": {
            "description": "Service Unavailable",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              },
              "text/json": {
                "schema": {
                  "$ref": "#/components/schemas/GetACHTransfersResponse"
                }
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "GetACHTransfersResponse": {
        "type": "object",
        "properties": {
          "totalRecordCount": {
            "type": "integer",
            "description": "The total number of ACH transfer records matching the request criteria.",
            "format": "int32"
          },
          "transfers": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/Transfer"
            },
            "description": "The list of ACH or account transfers for the account.",
            "nullable": true
          },
          "responseDetails": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/ResponseDetail"
            },
            "description": "Required: A list of response details providing status codes, descriptions, and additional information about the result of the operation.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Represents the response containing a list of ACH (Automated Clearing House) transfers for an account."
      },
      "ResponseDetail": {
        "type": "object",
        "properties": {
          "code": {
            "type": "integer",
            "description": "The primary status or error code for the response (e.g., 200 for success, 400 for validation error).",
            "format": "int32"
          },
          "subCode": {
            "type": "integer",
            "description": "An optional subcode providing more granular detail about the response or error.",
            "format": "int32",
            "nullable": true
          },
          "description": {
            "type": "string",
            "description": "A human-readable description of the response, error, or status.",
            "nullable": true
          },
          "url": {
            "type": "string",
            "description": "A URL linking to documentation or a web page with more information about the response code.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Represents a detailed status or error message for an API response.\r\nContains a code, optional subcode, human-readable description, and a URL for more information.\r\nUsed to provide granular feedback about the outcome of an operation, including success, warnings, or errors."
      },
      "Transfer": {
        "type": "object",
        "properties": {
          "achTransferType": {
            "type": "string",
            "description": "The type of ACH transfer (e.g., \"Credit\", \"Debit\", \"PPD\", \"CCD\").",
            "nullable": true
          },
          "transferIdentifier": {
            "type": "string",
            "description": "The unique identifier for this transfer.",
            "nullable": true
          },
          "accountIdentifier": {
            "type": "string",
            "description": "The unique identifier of the account associated with the transfer.",
            "nullable": true
          },
          "submissionDateTime": {
            "type": "string",
            "description": "The date and time when the transfer was submitted.",
            "format": "date-time"
          },
          "transactionAmount": {
            "type": "number",
            "description": "The amount of the transaction.",
            "format": "double"
          },
          "achTransferStatus": {
            "type": "string",
            "description": "The current status of the ACH transfer (e.g., \"Pending\", \"Completed\", \"Returned\").",
            "nullable": true
          },
          "returnDateTime": {
            "type": "string",
            "description": "The date and time when the transfer was returned, if applicable.",
            "format": "date-time",
            "nullable": true
          },
          "returnReasonCode": {
            "type": "string",
            "description": "The reason code for a returned transfer, if applicable.",
            "nullable": true
          },
          "returnStatus": {
            "type": "string",
            "description": "The status of the returned transfer, if applicable.",
            "nullable": true
          },
          "expectedDeliveryDate": {
            "type": "string",
            "description": "The expected delivery date and time for the transfer, if available.",
            "format": "date-time",
            "nullable": true
          },
          "bankAccountType": {
            "type": "string",
            "description": "The type of bank account involved in the transfer (e.g., \"Checking\", \"Savings\").",
            "nullable": true
          },
          "institutionName": {
            "type": "string",
            "description": "The name of the financial institution associated with the bank account.",
            "nullable": true
          },
          "last4BankAccountNumber": {
            "type": "string",
            "description": "The last four digits of the bank account number involved in the transfer.",
            "nullable": true
          }
        },
        "additionalProperties": false,
        "description": "Represents an ACH or account transfer, including identifiers, status, transaction details, and bank account metadata.\r\nUsed to communicate the state and details of a transfer operation for reporting, tracking, and reconciliation purposes.\r\nSupports business logic for ACH processing, returns, delivery estimation, and compliance."
      }
    },
    "securitySchemes": {
      "Bearer": {
        "type": "apiKey",
        "description": "bearer token",
        "name": "Authorization",
        "in": "header"
      }
    }
  },
  "security": [
    {
      "Bearer": []
    }
  ],
  "x-readme": {
    "explorer-enabled": false,
    "proxy-enabled": false,
    "samples-languages": [
      "csharp",
      "java",
      "python",
      "node",
      "objectivec"
    ]
  }
}
```