--- title: Update Form POI slug: investor-onboarding-io/update-form-poi description: Learn how to update Point of Interest (POI) form data for merchants with our comprehensive document. Get the details on the endpoint, headers, and input information for the updateForm API. Discover the necessary properties and data types for identity veri docTags: createdAt: 2023-06-21T11:25:44.000Z --- Update the POI form data of a Merchant. Only the POI that has been approved for the distributor by the AMC will be accepted and any other ID uploaded will throw an error. So if for a particular distributor, if PAN card is the only approved POI, then uploading Aadhaar as POI will throw an error. ## Endpoint **/api/onboardings/updateForm** ## 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 the investor login response field | | save | String (*Required*) | “formData” | | type | String (*Required*) | “identityProof” | | data | Object (*Required*) | payload, see below for details | ### Object Details when POI is PAN ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "individualPan", "name": ".. name ..", "fatherName": ".. fatherName ..", "number": ".. Pan number ..", "dob": ".. dob .." } } ``` | **Property** | **Data Type** | **Example Values** | | ------------ | ------------------------------------------------------------------------------- | -------------------------- | | type | Enum String (*Required*) | “individualPan” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | | number | String (*Required*), valid PAN number | PAN number on POI document | | fatherName | String (*Required*), string of min length of 2 consisting of any character | PAN number on POI document | ### Object Details when POI is Aadhaar ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "aadhaar", "name": ".. person name ..", "uid": "..12 digit UID ..", "address": ".. address ..", "city": ".. city ..", "state": ".. state ..", "district": ".. district ..", "pincode": ".. pincode ..", "dob": ".. dob .." } } ``` | **Property** | **Data Type** | **Example Values** | | ------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------- | | type | Enum String (*Required*) | “aadhaar” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | uid | String (*Required*), string of 8 zeros followed by 4 digits | Aadhaar number | | address | String (*Required*) | Address as on POI document | | city | Enum String (*Required*) | City as on POI document | | state | Enum String (*Required*) | State as on POI document, Refer 1st column of Table 1.7 | | district | String (*Required*) | District as on POI document | | pincode | String (*Required*), valid Pincode | Pincode | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | ### Object Details when POI is Passport ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "passport", "name": ".. name ..", "birthDate": ".. dob ..", "issueDate": ".. issueDate ..", "expiryDate": ".. expiryDate ..", "passportNumber": ".. passport number ..", "address": ".. address ..", "city": ".. city ..", "state": ".. state ..", "district": ".. district ..", "pincode": ".. pincode .." } } ``` | **Property** | **Data Type** | **Example Values** | | -------------- | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- | | type | Enum String (*Required*) | “passport” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | passportNumber | String (*Required*) | Passport number | | address | String (*Required*) | Address as on POI document | | city | Enum String (*Required*) | City as on POI document | | state | Enum String (*Required*) | State as on POI document, Refer 1st column of Table 1.7 | | district | String (*Required*) | District as on POI document | | birthDate | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | | pincode | String (*Required*), valid Pincode | Pincode | | issueDate | String (*Required*), Issue Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a past Date | Issue date on the document | | expiryDate | String (*Required*), Expiry Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a future Date | Expiry date on the document | ### Object Details when POI is Driving License ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "drivingLicence", "name": ".. name ..", "expiryDate": "... expiryDate ..", "number": ".. DL number ..", "dob": ".. dob .. ", "issueDate": ".. issueDate ...", "address": ".. address ..", "city": ".. city ..", "state": ".. state ..", "district": ".. district ..", "pincode": ".. pincode .." } } ``` | **Property** | **Data Type** | **Example Values** | | ------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- | | type | Enum String (*Required*) | “drivingLicence” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | | number | String (*Required*) | Driving License number on the POI document | | address | String (*Required*) | Address as on POI document | | city | Enum String (*Required*) | City as on POI document | | state | Enum String (*Required*) | State as on POI document, Refer 1st column of Table 1.7 | | district | String (*Required*) | District as on POI document | | pincode | String (*Required*), valid Pincode | Pincode | | issueDate | String (*Required*), Issue Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a past Date | Issue date on the document | | expiryDate | String (*Required*), Expiry Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a future Date | Expiry date on the document | ### Object Details when POI is VoterId ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "voterId", "epicNumber": ".. voterId number ..", "name": ".. name ..", "dob": ".. dob ..", "state": ".. state ..", "district": ".. district ..", "address": ".. address ..", "city": ".. city ..", "pincode": ".. pincode .." } } ``` | **Property** | **Data Type** | **Example Values** | | ------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------- | | type | Enum String (*Required*) | “voterId” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | | epicNumber | String (*Required*) | VoterId number on POI document | | address | String (*Required*) | Address as on POI document | | city | Enum String (*Required*) | City as on POI document | | state | Enum String (*Required*) | State as on POI document, Refer 1st column of Table 1.7 | | district | String (*Required*) | District as on POI document | | pincode | String (*Required*), valid Pincode | Pincode | ### Object Details when POI is Offline Aadhaar ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "aadhaarXml", "name": ".. person name ..", "uid": "..12 digit UID ..", "address": ".. address ..", "city": ".. city ..", "state": ".. state ..", "district": ".. district ..", "pincode": ".. pincode ..", "dob": ".. dob ..", "generationDateTime": "..generationDate+generationTime..", "dateDifference": ..dateDifference.. } } ``` | **Property** | **Data Type** | **Example Values** | | ------------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------- | | type | Enum String (*Required*) | “aadhaarXml” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | uid | String (*Required*), string of 8 zeros followed by 4 digits | Aadhaar number | | address | String (*Required*) | Address as on POI document | | city | Enum String (*Required*) | City as on POI document | | state | Enum String (*Required*) | State as on POI document, Refer 1st column of Table 1.7 | | district | String (*Required*) | District as on POI document | | pincode | String (*Required*), valid Pincode | Pincode | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | | generationDateTime | String (*Required*), concat the generationDate and generationTime | Generation date and time on the POI document | | dateDifference | Number (*Required*) ,dateDiffence | dateDifference in POI document | ### Object Details when POI is Aadhaar DigiLocker ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "aadhaarDigiLocker", "name": ".. person name ..", "uid": "..12 digit UID ..", "address": ".. address ..", "city": ".. city ..", "state": ".. state ..", "district": ".. district ..", "pincode": ".. pincode ..", "dob": ".. dob .." } } ``` | **Property** | **Data Type** | **Example Values** | | ------------ | ------------------------------------------------------------------------------- | ------------------------------------------------------- | | type | Enum String (*Required*) | “aadhaarDigiLocker” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | uid | String (*Required*), string of 8 zeros followed by 4 digits | Aadhaar number | | address | String (*Required*) | Address as on POI document | | city | Enum String (*Required*) | City as on POI document | | state | Enum String (*Required*) | State as on POI document, Refer 1st column of Table 1.7 | | district | String (*Required*) | District as on POI document | | pincode | String (*Required*), valid Pincode | Pincode | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | ### Object Details when POI is PAN DigiLocker ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "panDigiLocker", "name": ".. name ..", "fatherName": ".. fatherName ..", "number": ".. Pan number ..", "dob": ".. dob .." } } ``` | **Property** | **Data Type** | **Example Values** | | ------------ | ------------------------------------------------------------------------------- | -------------------------- | | type | Enum String (*Required*) | “panDigiLocker” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | | number | String (*Required*), valid PAN number | PAN number on POI document | | fatherName | String (*Required*), string of min length of 2 consisting of any character | PAN number on POI document | ### Object Details when POI is Driving License DigiLocker ```json { "merchantId": ".. merchantId ..", "save": "formData", "type": "identityProof", "data": { "type": "dlDigiLocker", "name": ".. name ..", "expiryDate": "... expiryDate ..", "number": ".. DL number ..", "dob": ".. dob .. ", "issueDate": ".. issueDate ...", "address": ".. address ..", "city": ".. city ..", "state": ".. state ..", "district": ".. district ..", "pincode": ".. pincode .." } } ``` | **Property** | **Data Type** | **Example Values** | | ------------ | ------------------------------------------------------------------------------------------------------ | ------------------------------------------------------- | | type | Enum String (*Required*) | “dlDigiLocker” | | name | String (*Required*), string of min length of 2 consisting of any character | Name on POI document | | dob | String (*Required*), date of birth as string in DD/MM/YYYY or DD-MM-YYYY format | DOB on POI document | | number | String (*Required*) | Driving License number on POI document | | address | String (*Required*) | Address as on POI document | | city | Enum String (*Required*) | City as on POI document | | state | Enum String (*Required*) | State as on POI document, Refer 1st column of Table 1.7 | | district | String (*Required*) | District as on POI document | | pincode | String (*Required*), valid Pincode | Pincode | | issueDate | String (*Required*), Issue Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a past Date | Issue date on the document | | expiryDate | String (*Required*), Expiry Date as string in DD/MM/YYYY or DD-MM-YYYY format, should be a future Date | Expiry date on the document | ## Expected Output ```json { "object": "Updated Successfully" } ``` :::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](#). :::