---
title: Push Application Data
slug: generic-onboarding/push-application-data
description: Learn how to use the API to push data into the GO platform for validation and operations with this comprehensive document. Discover the essential parameters required for the request, including flowId, realmId, merchantId, pageId, widgetName and parameter_
createdAt: 2023-02-14T12:53:02.000Z
---

# Introduction

Once the application is created the data has to be pushed into the GO platform for further validation and operations to be performed. The same is done using the following API.

## Sample Request

::::Tabs
:::Tab{title="Preproduction"}
```curl
curl --location 'https://go-preproduction.signzy.app/api/v1/externalPushMerchant/{Merchant ID}' \
--header 'Content-Type: application/json' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Auth Token>' \
--data '{
    "formData": [
        {
            "data": {
                "form1 label1": "form 1 val 1",
                "form1 label2": "form 1 val 2",
                "image1": "<Persist link>",
                "image2": "<Persist Link>"
            },
            "pageName": "form page 1",
            "deletePage": false
        },
        {
            "data": {
                "form2 label1": "form 2 val 1",
                "form2 label2": "form 2 val 2",
                "images": [
                    "<Persist Link>",
                    "<Persist Link>"
                ]
            },
            "pageName": "form page 2",
            "deletePage": false
        }
    ],
    "documents": [
        {
            "data": {
                "doc1 label1": "doc 1 val 1",
                "doc1 label2": "doc 1 val 2",
                "image1": "<Persist link>",
                "image2": "<Persist Link>"
            },
            "pageName": "doc page 1",
            "pageType": "doc 1"
        },
        {
            "data": {
                "doc2 label1": "doc 2 val 1",
                "doc2 label2": "doc 2 val 2",
                "images": [
                    "<Persist link>",
                    "<Persist link>"
                ]
            },
            "pageName": "doc page 2",
            "pageType": "doc 2"
        }
    ],
    "contract": {
        "contractResult": {
            "contractId": "<Contract ID>",
            "contractCreationTime": "<Timestamp>",
            "initialSignerCount": 1,
            "signedSignerCount": 1,
            "cancelledSignerCount": 0,
            "deletedSignerCount": 0,
            "contractName": "<Name>",
            "contractExecuterName": "<Name>",
            "signerCallbackUrl": "",
            "callbackUrlAuthorizationHeader": "",
            "signerCallbackUrlAuthorizationHeader": "",
            "contractTtl": 1209600,
            "initialContract": "<Persist link>",
            "initialContractHash": "<Hash>",
            "finalSignedContract": "<Persist link>",
            "finalSignedContractHash": "<Hash>",
            "auditCertificateUrl": "<Persist link>",
            "auditCertificateHash": "<Hash>",
            "isCompleted": true,
            "contractCompletionTime": "<Timestamp>",
            "contractCancelTimestamp": "",
            "contractStatus": "COMPLETED",
            "customerMailList": [],
            "endOfLife": 16761600,
            "callbackStatus": {},
            "locationCaptureMethod": "BROWSER",
            "signerdetail": [
                {
                    "signerName": "<Name>",
                    "signerGender": "NA",
                    "signerYearOfBirth": "NA",
                    "uidLastFourDigits": "",
                    "workflowUrl": "<Contracting Workflow URL>",
                    "signerId": "<Signer ID>",
                    "signatureType": "SMARTESIGN",
                    "additionalSignatureTypes": [
                        "CLICKWRAP"
                    ],
                    "contractLastSignTime": "<Time>",
                    "contractSendTime": "<Time>",
                    "status": "SUCCESS",
                    "signerCancelMessage": "",
                    "selectedSignatureType": "SMARTESIGN",
                    "errorMessage": "NA",
                    "aadhaarStatus": "",
                    "aadhaarErrorMessage": "NA",
                    "nameMatchResult": "",
                    "signerIP": "<IP>",
                    "noOfSuccessfulAttempts": 1,
                    "signerSignedContract": "<Persist link>",
                    "signerSignedContractHash": "<Hash>",
                    "esignAttempts": [
                        {
                            "sessionId": "<Session ID>",
                            "signerIP": "<IP>",
                            "workflowUrlOpentime": "<Timestamp>",
                            "role": "SIGNER",
                            "workflowUrlOpenedFrom": "direct",
                            "forensics": {
                                "userBrowserData": {
                                    "browserCodeName": "Mozilla",
                                    "browserName": "<Browser Name>",
                                    "browserVersion": "<Version>",
                                    "cookieEnabled": true,
                                    "browserLanguage": "en-US",
                                    "os": "<OS Version>",
                                    "userAgent": "<Version>"
                                },
                                "geoLocationData": {
                                    "latitude": <Lat>,
                                    "longitude": <Long>
                                }
                            },
                            "signatureSelectTime": "<Timestamp>",
                            "selectedSignatureType": "SMARTESIGN",
                            "signingCompleteTime": "<Timestamp>",
                            "transactionHistory": []
                        }
                    ]
                }
            ],
            "deletedsignerdetail": [],
            "reviewerdetail": []
        },
        "pageType": "Contract360"
    },
    "changeStatus": "pending"
}'
```
:::
::::

## Request Field Description

| **Parameters** | **Required/Optional** | **Description**                                                                                                                                                   |
| -------------- | --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| flowId         | required              | The "flowid" refers to a specific onboarding journey created within the GO platform. This helps segregate different types of applications from one another.<br /> |
| realmId        | required              | This is an identifier used by the GO platform, the same will be provided by the  Signzy team.                                                                     |
| merchantId     | required              | The "merchantid" refers to the identifier generated in step 2 after creating a new application.                                                                   |
| pageId         | required              | The "pageId" refers to a particular page within the onboarding flow configured in the GO platform.                                                                |
| widgetName     | required              | The "widgetName" refers to any specific function/module being used within a page for verification or other operations.                                            |
| parameter\_n   | required/optional     | There are many data points collected during an onboarding journey, the same are pushed to the GO platform under the parameters.                                   |

# Sample Response

:::CodeblockTabs
200: OK

```json
{
 "result": "Successfully Pushed"
}

```

400: Bad Request

```json
{ 
   "error":{ 
   "statusCode":400,
    "name":"Error",
    "message":"Not a valid status" 
   } 
}

```

401: Unauthorized

```json
{
   "error":{
         "statusCode":401,
          "name":"Error",
           "message":"Authorization Required", 
            "code":"AUTHORIZATION_REQUIRED"
     } 
}

```

404: Not Found

```json
{
   "error": {
       "statusCode": 404,
       "name": "Error",
       "message": "Shared class \"Patron\" has no method handling POST /login/1232",
       "status": 404
   }
}

```
:::

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