---
title: Execute Verify Bank Account verifyAccount
slug: investor-onboarding-io/execute-verify-bank-account-verifyaccount
description: Learn about the "/api/onboardings/execute" API endpoint and its required headers. Understand the input structure, including merchantId and inputData object with service, type, task, and data properties. Explore the data property with images, toVerifyData,
docTags: 
createdAt: 2023-06-19T12:35:58.000Z
---

## Endpoint

**/api/onboardings/execute**

## Headers

| **Property**  | **Value**                                         |
| ------------- | ------------------------------------------------- |
| Content-type  | application/json                                  |
| Authorization | …access token… (alphanumeric string of length 64) |

## Input

| **Property**   | **Data Type**                                        | **Example Values**                                     |
| -------------- | ---------------------------------------------------- | ------------------------------------------------------ |
| merchantId     | String (*Required*) alphanumeric string of length 24 | userId from investor login response                    |
| inputData      | Object (*Required*)                                  | Metadata along with actual payload to be executed upon |
| – service      | Enum String (*Required*)                             | “nonRoc”                                               |
| – type         | Enum String (*Required*)                             | “bankaccountverifications”                             |
| – task         | Enum String (*Required*)                             | “verifyAmount”                                         |
| – data         | Object (*Required*)                                  | payload                                                |
| —- searchParam | Object (*Required*)                                  | see below for details                                  |

### searchParam Object Details

```json
{
    "merchantId": ".......",
    "inputData": {
        "service": "nonRoc",
        "type": "bankaccountverifications",
        "task": "verifyAmount",
        "data": {
            "images": [],
            "toVerifyData": {},
            "searchParam": {
                "amount": ".......",
                "signzyId": "......."
            }
        }
    }
}
```

| **Property** | **Data Type**                                               | **Example Values**                                                     |
| ------------ | ----------------------------------------------------------- | ---------------------------------------------------------------------- |
| amount       | Positive Number (*Required*)                                | Amount transferred from previous (Penny transfer) execute the API call |
| signzyId     | String (*Required*), alphanumeric string of length 51 or 52 | signzyReferenceId from Penny transfer API call’s response              |

## Expected Output

```json
{
    "object": {
        "result": {
            "amountMatch": "false | true",
            "ownerName": ".......",
            "mobile": ".......",
            "mmid": "......."
        }
    }
}
```

:::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](#).
:::