---
title: Execute Recorded Video
slug: investor-onboarding-io/execute-recorded-video
description: Learn how to execute an effective onboarding process with video verification using this comprehensive document. Discover the necessary headers and input data format, including the merchant ID, video URL, and transaction ID. Obtain a JSON object containing
docTags: 
createdAt: 2023-06-19T12:35:44.000Z
---

**Note**: Acceptable format: .mp4 format with video encoding of H264 and audio encoding of AAC (Advanced Audio Coding)

## Endpoint

**/api/onboardings/execute**

## Headers

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

## Input

```json
{
   "merchantId":".. merchantId ..",
   "inputData":{
      "service":"video",
      "type":"video",
      "task":"verify",
      "data":{
         "video":".. video URL ..",
         "transactionId":".. transactionId ..",
         "matchImage":".. URL of POI Image containg user Photo ..",
         "seconds":[
            "00:00:02",
            "00:00:04",
            "00:00:06",
            "00:00:08"
         ],
         "type":"video"
      }
   }
}
```

| **Property**    | **Data Type**                                                                                                                              | **Example Values**                                                                                                          |
| --------------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| merchantId      | String (*Required*) alphanumeric string of length 24                                                                                       | userId from the investor login response field                                                                               |
| inputData       | Object (*Required*)                                                                                                                        | payload                                                                                                                     |
| –service        | Enum String (*Required*)                                                                                                                   | “video”                                                                                                                     |
| –type           | Enum String (*Required*)                                                                                                                   | “video”                                                                                                                     |
| –task           | Enum String (*Required*)                                                                                                                   | “verify”                                                                                                                    |
| –data           | Object(*Required*)                                                                                                                         | payload containing video details                                                                                            |
| —-video         | URL String (*Required*)                                                                                                                    | Video URL                                                                                                                   |
| —-snapshot      | URL String (*Optional*)                                                                                                                    | Image URL of snapshot from video containing user’s face                                                                     |
| —-transactionId | String (*Required*), must be an alphanumeric string of length 30                                                                           | transaction Id received in the start video API call                                                                         |
| —-matchImage    | URL String (*Required*)                                                                                                                    | URL of POI Image containing user Photo                                                                                      |
| —-seconds       | Array of moment strings at which face was detected in the video" (*Optional*), must contain moments in a valid format, example: “00:00:08” | Array of moment strings at which face was detected in the video" (*Optional*), must contain moments in valid format details |
| —-type          | Enum String (*Required*)                                                                                                                   | “video”                                                                                                                     |

## Expected Output

```json
{
    "object": {
        "n": 1,
        "nModified": 1,
        "ok": 1
    }
}
```

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