---
title: "Get ACH Accounts"
method: POST
path: "/getAchAccounts"
tags: ["Transactions"]
---

# Get ACH Accounts

`POST /getAchAccounts`

## Request

- Base URL: `api-{corename}.{env}.gpsrv.com/intserv/4.0/` (relative, and the document’s source URL is not known)
- URL: `api-{corename}.{env}.gpsrv.com/intserv/4.0/getAchAccounts`
- Auth: none declared

Use the Get ACH Accounts endpoint to retrieve a record of ACH accounts that are linked to a customer account.

For instructions on using this endpoint see <a href="doc:ach-endpoints#viewing-ach-accounts" target="_blank">Viewing ACH accounts</a> in the *ACH Endpoints* guide.

[block:callout]

{
"type": "warn",
"title": "Warning",
"body": "If you plan to display ACH account and routing numbers to customers, be aware that the `accountNo` and `routingNo` returned by this endpoint may be tokenized if an aggregator service (such as Plaid) is used. Only display these values to customers if you are sure they will not be tokenized."
}
[/block]

## Request body `application/x-www-form-urlencoded`

- object
  - `apiLogin` string, required: Web service username, as provided by SoFi Tech Solutions. Pattern: Max 50 characters Example: `"AbC123-9999"`
  - `apiTransKey` string, required: Web service password, as provided by SoFi Tech Solutions. Pattern: Max 15 characters Example: `"4sb62fh6w4h7w34g"`
  - `providerId` integer, required: Your unique provider identifier from SoFi Tech Solutions. Pattern: Max 10 digits Example: `9999`
  - `transactionId` string, required: Supply a globally unique ID to identify this endpoint request ("transaction"). Might be used for <a href="ref:idempotency#endpoints-that-use-transactionid-for-idempotency" target="_blank">idempotency</a>. A UUID is preferred. Pattern: Maximum 60 characters Example: `"9845dk-39fdk3fj3-4483483478"`
  - `accountNo` string, required: The <<glossary:PRN>> or <<glossary:PAN>> of the account. Pattern: PAN or PRN Example: `"074103447228"`

## Response `default`

- object
  - `status_code` integer, nullable, required: The response status code. May return a string for some statuses.
  - `status` string, nullable, required: The condition of a process or response
  - `processing_time` number, float, nullable, required: The time elapsed in processing the transaction
  - `echo` object, nullable, required: A structure that contains transaction ID information
    - `transaction_id` string, nullable, required: An ID that represents an API transaction
    - `provider_timestamp` string, date-time, nullable, required: Store a related timestamp for reporting and troubleshooting purposes
    - `provider_transaction_id` string, nullable, required: Secondary transaction identifier (generated by a provider)
  - `system_timestamp` string, date-time, nullable, required: A system generated timestamp
  - `rtoken` string, nullable, required: A system-generated ID used for tracking
  - `errors` string[]: A list of errors generated while the request was processed
  - `response_data` object, nullable, required: A structure for the response data. It can be empty but usually will contain information.
    - `found` integer, required: The number of ACH accounts found
    - `ach_accounts` object[], required: List of ACH accounts
      - `ach_account_id` string, required: A unique ID for an ACH account
      - `status` string, required: The status of the ACH account. See <a href="ref:api-reference-ach-account-statuses" target="_blank">ACH Account Statuses</a>.
      - `routing_no` string, required: A 9-digit number that specifies a financial institution
      - `account_no` string, required: The account number at the remote financial institution
      - `type` string, required: The type of account
      - `name` string, nullable, required: The display name of the ACH account
      - `company_name` string, nullable, required: Name of the company that owns the ACH account. Returned when `entity_type: C`.
      - `entity_type` string, nullable, required: Type of account holder of the ACH account: individual (`I`) or company (`C`).
      - `first_name` string, nullable, required: First name of the ACH account holder. Returned when `entity_type: I`.
      - `last_name` string, nullable, required: Last name of the ACH account holder. Returned when `entity_type: I`
      - `file_first_name` string, nullable, required: First name of the individual account holder that is used in the outgoing Nacha file. Returned when `entity_type: I`
      - `file_last_name` string, nullable, required: Last name of the individual account holder that is used in the outgoing Nacha file. Returned when `entity_type: I`
      - `file_company_name` string, nullable, required: Name of the company account holder that is used in the outgoing Nacha file. Returned when `entity_type: C`.

## Changes

- **2026-11-03** `1ede7567a879`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/galileo-ft/apis/program-api/changes/getAchAccounts/post.md)

---

[API](https://skmtc.dev/galileo-ft/apis/program-api.md) - [All operations](https://skmtc.dev/galileo-ft/apis/program-api/llms.txt) - [OpenAPI document](https://skmtc.dev/galileo-ft/apis/program-api/revisions/1ede7567a879?raw)