Get Account ACH Details
Introduction
The "Get Account ACH Details" API, integrated with Finicity, allows you to retrieve the Automated Clearing House (ACH) details for a customer's specified account. This information is commonly used for tasks such as account opening or initiating payments.
To make use of this API, you need to provide the customer's unique identifier (customerId) and the account identifier (accountId). By utilizing this API, you can obtain the authentic account number and routing number details required for processing ACH payments.
The API supports various types of accounts, including checking, savings, money market, and loans. It is specifically designed to cater to the United States region, ensuring compliance with the ACH standards and regulations applicable in the US.
Supported regions: US
API Details
This API requires two inputs:
- CustomerID: The unique identifier for the customer.
- AccountID: The unique identifier for the account.
To obtain the required IDs, you need to follow these steps:
- Create a customer and initiate the Finicity journey for them by using the Create bank connect journey link API.
- Retrieve the results from the API to obtain the Customer ID and the corresponding Account IDs.
- Execute this API to get the Account ACH Details
Please note that the customer and Finicity journey need to be created beforehand in order to obtain the necessary IDs.
Sample cURL
curl --location --request POST 'https://api-preproduction.signzy.app/api/v3/bank-connect/account-owner' \
--header 'Authorization: <Token>' \
--header 'Content-Type: application/json' \
--data-raw '{
"customerId": "6018678884",
"accountId": "6032346608"
}'Request Body Parameters
Parameter name | Data type | Required | Description |
|---|---|---|---|
customerId | string | Yes | The customer Id which was obtained in the response of Create bank connect journey link API. This is customer ID of the customer account whose owner details are to be fetched |
accountId | string | Yes | The account Id for a specific account of the customer obtained in the response of Create bank connect journey link API. This is account ID of the customer account whose owner details are to be fetched |
Sample Response
{
"routingNumber": "123456789",
"realAccountNumber": 2345678901
}Response Body Parameters
Parameter name | Data type | Description |
|---|---|---|
routingNumber | string | The routing number of the financial institution for this specific customers account example:Â "123456789" |
realAccountNumber | string | The account number for associated with this account example:Â 2345678901 |
Sample Error
{
"error": {
"name": "error",
"message": "Invalid Date",
"status": 400,
"reason": "VALIDATION_ERROR",
"type": "Bad Request",
"statusCode": 200
}
}Error Response Parameters
Parameter | Description |
|---|---|
error | This parameter contains the error. |
error.name | the name of the error |
error.message | the error message |
error.status | status of the api |
error.reason | Reason for error |
error.type | Type of the error |
error.statusCode | Request Status code from Signzy |
Getting help
Please feel free to contact us if you have any questions, require clarification, or have ideas for how to make the documents or any of our services better.
You can reach out to us at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!