---
title: Instant Bank Account Verification - US
slug: us-apis/instant-bank-account-verification-us
docTags: 
createdAt: 2024-08-05T13:50:43.789Z
---

## Introduction

Our instant bank account verification flow is designed to provide secure and efficient account verification services across various countries, including the United States. This process allows businesses and financial institutions to verify bank account details instantly, streamlining the onboarding process and enhancing the overall user experience.

**Use Cases:**

1. **Cross-Border Transactions:**
   - Facilitate cross-border transactions by quickly and accurately verifying bank account details, enabling secure and efficient international money transfers.
2. **Enhanced Onboarding Process:**
   - Streamline the customer onboarding journey by automating the bank account verification process, reducing manual efforts, and minimizing the risk of errors.
3. **Risk Mitigation:**
   - Minimize the risk of fraudulent activities by validating bank account details through a robust and reliable verification process, providing an additional layer of security.
4. **Currency Confirmation:**
   - Obtain information on the currency associated with the provided bank account, allowing businesses to ensure compatibility and accuracy in financial transactions.

### Bank Account Validation Flow

![](https://lh7-us.googleusercontent.com/KC2yqESACsxFSIPo7IUcH_WWXTPCU1vjpVG1DwUQPMx4K_ZUWLdWtKbztxotYMzpAMv85V40cdKL2IEWqb-bQYWb01ndrqQdcp8N1fWfBnU4mBk4QDegUd9e1ZJZGiii3oFFDKGo6qDv267UJtnskravBA=s2048)

![](https://lh7-us.googleusercontent.com/qYlnlGPTIIU0je7nVAEr74YfSd7eTxBFjjd7I8CP0VCn5yMtYpl241BVCh0sv_1JYJpWbNwyXh5AX77iT3LwalPVVOM3OaXVjbMxTMwiN0WC9NrFWavGTheMyuS5oSfoaxbkyQ23_LMIp-GbMtxkz1XysQ=s2048)

## API description

### Sample cURL

:::CodeblockTabs
Pre-production

```curl
curl --location 'https://api-preproduction.signzy.us/api/v3/global-bank-verification/validate-bank-account/us' \
--header 'Authorization: YOUR_API_KEY' \
--header 'Content-Type: application/json' \
--data '{
     "fullName":   "Abc", 
     "isBusiness" : true,
     "accountNumber": "781245633",
     "clearingSystemId": "101000019"
}'
```

Production

```curl
curl --location 'https://api.signzy.us/api/v3/global-bank-verification/validate-bank-account/<Country code>' \
--header 'Authorization: YOUR_API_KEY' 
--header 'Content-Type: application/json' \
--data '{
     "fullName":   "Abc", 
     "isBusiness" : true,
     "accountNumber": "781245633",
     "clearingSystemId": "101000019"
}'
```
:::

****
****
**Headers**

| Key           | Value                                                |
| ------------- | ---------------------------------------------------- |
| Authorization | access token (returned as id field of login request) |
| Content-type  | application/json                                     |

### Request Data

```json
{
     "fullName":   "Abc", 
     "isBusiness" : true,
     "accountNumber": "781245633",
     "clearingSystemId": "101000019"
}
```

### Request Data Parameters

| Parameter        | Description                                                                       | Validation Checks    | Type    | Required                                                |
| ---------------- | --------------------------------------------------------------------------------- | -------------------- | ------- | ------------------------------------------------------- |
| fullName         | Full name of bank account holder                                                  | Any non empty string | String  | Mandatory for all countries except when country is "US" |
| accountNumber    | Account number of bank account                                                    | Alphanumeric         | String  | Mandatory                                               |
| clearingSystemId | Clearing system codes of financial institutions  associated with the bank account | Alphanumeric         | String  | Mandatory                                               |
| isBusiness       | isBusiness                                                                        | boolean              | boolean | Mandatory                                               |

### Sample Response

:::CodeblockTabs
Success (200)

```json
{
    "result": {
        "description": "Bank Account Verified",
        "matchScore": "0.99",
        "matchScoreDescription": "Strong Match",
        "nameMatched": "",
        "currency": ""
        }
    }
}
```

Success (200)

```json
{
    "result": {
        "description": "Account number not found",
        "matchScore": "",
        "matchScoreDescription": "",
        "nameMatched": "",
        "currency": ""
        }
    }
}
```

Bad Request (400)

```json
{
    "error": {
        "name": "error",
        "message": "Bad Request",
        "status": 400,
        "reason": "fullName REQUIRED",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

Bad Request (400)

```json
{
    "error": {
        "name": "error",
        "message": "Bad Request",
        "status": 400,
        "reason": "givenName NOT REQUIRED",
        "type": "Bad Request",
        "statusCode": "400"
    }
}
```

Upstream Down (409)

```json
{
    "error": {
        "name": "error",
        "message": "Upstream Error",
        "reason": "ERROR",
        "type": "Conflict",
        "statusCode": "409"
    }
}
```
:::

### Success Response Body Parameters

| Key                                   | Description                                        | Type   |
| ------------------------------------- | -------------------------------------------------- | ------ |
| result.description                    | Validation description                             | String |
| result.country                        | country associated with bank account               | String |
| result.response.matchScore            | Degree of matching                                 | Float  |
| result.response.matchScoreDescription | Description reflecting the strength of the match   | String |
| result.response.nameMatched           | Name that achieved the match                       | String |
| result.response.currency              | Currency associated with the validated information | String |

### Country Details



| Country | Creditor (Full Name) | Creditor Account (Account number) | Creditor Agent (Clearing system ID) | Match\_Score                                                     | Match\_Score\_Description | Data Remarks |
| ------- | -------------------- | --------------------------------- | ----------------------------------- | ---------------------------------------------------------------- | ------------------------- | ------------ |
| US      | Name                 | beneficiary bank account ID       | ABA code as clearing system ID      | Discrete values representative of strength of match (1, 0, etc.) | Strong, Weak              | n/a          |

### Error Codes

| Error Code | Description                                             |
| ---------- | ------------------------------------------------------- |
| 200        | Success - The request was processed successfully.       |
| 400        | Bad Request - The request was malformed or invalid.     |
| 409        | Conflict - The request conflicts with the server state. |
| 500        | Internal Server Error - An unexpected error occurred.   |

:::hint{type="info"}
### 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 [help@signzy.com](#). 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!
:::