Onboarding APIs
Update Fatca Form
10 min
endpoint /api/onboardings/updateform headers property value content type application/json authorization âŚaccess token⌠(alphanumeric string of length 64) input { "merchantid" " ", "save" "formdata", "type" "fatca", "data" { "type" "fatca", "fatcadata" { "pep" " ", "rpep" " ", "residentfortaxinindia" " ", "relatedperson" " ", "addresstype" " ", "countrycodejurisdictionresidence" " ", "countryjurisdictionresidence" " ", "taxidentificationnumber" " ", "placeofbirth" " ", "countrycodeofbirth" " ", "countryofbirth" " ", "addresscity" " ", "addressdistrict" " ", "addressstatecode" " ", "addressstate" " ", "addresscountrycode" " ", "addresscountry" " ", "addresspincode" "543534", "address" " ", "relatedpersontype" " ", "relatedpersonkycnumber" "44354355", "relatedpersonkycnumberexists" " ", "relatedpersontitle" " ", "relatedpersonidentityproof" { "name" " ", "fathername" " ", "dob" " ", "number" " " }, "relatedpersonname" " ", "relatedpersonidentityprooftype" " " } } } property data type example values merchantid string ( required ), alphanumeric string of length 24 userid from investor login response field save enum string ( required ) âformdataâ type enum string ( required ) âfatcaâ data object ( required ) payload âtype enum string ( required ) âfatcaâ âfatcadata object ( required ) fatca data â pep enum string ( required ) whether a 'politically exposed personâ values âyesâ/ânoâ â rpep enum string ( required ) whether a 'related to a politically exposed personâ values âyesâ/ânoâ â residentfortaxinindia enum string ( required ) whether a 'resident outside of indiaâ values âyesâ/ânoâ â countrycodejurisdictionresidence enum string ( optional ) country of jurisdiction of residence code (refer table 1 1), to be provided given âresidentfortaxinindiaâ is âyesâ â countryjurisdictionresidence string( optional ) country of jurisdiction of residence (refer table 1 1), to be provided given âresidentfortaxinindiaâ is âyesâ â taxidentificationnumber string( optional ) tax identification number, to be provided given âresidentfortaxinindiaâ is âyesâ â placeofbirth string( optional ) place of birth, to be provided given âresidentfortaxinindiaâ is âyesâ â countrycodeofbirth enum string( optional ) country code of birth (refer table 1 1), to be provided given âresidentfortaxinindiaâ is âyesâ â countryofbirth string( optional ) country of birth (refer table 1 1), to be provided given âresidentfortaxinindiaâ is âyesâ â addresstype string( optional ) type of fatca address, values âcorrespondenceâ / âothersâ, to be provided given âresidentfortaxinindiaâ is âyesâ â addresscity string( optional ) fatca address city, to be provided given âresidentfortaxinindiaâ is âyesâ â addressdistrict string ( optional ) fatca address district, to be provided given âresidentfortaxinindiaâ is âyesâ â addressstatecode enum string( optional ) fatca address state code (refer table 1 2), to be provided given âresidentfortaxinindiaâ is âyesâ â addressstate string( optional ) fatca address state (refer table 1 2), to be provided given âresidentfortaxinindiaâ is âyesâ â addresscountrycode enum string( optional ) fatca address country code (refer table 1 1), to be provided given âresidentfortaxinindiaâ is âyesâ â addresscountry string( optional ) fatca address country (refer table 1 1), to be provided given âresidentfortaxinindiaâ is âyesâ â addresspincode string( optional ), valid pincode fatca address pincode, to be provided given âresidentfortaxinindiaâ is âyesâ â address string( optional ) fatca address, to be provided given âresidentfortaxinindiaâ is âyesâ â relatedperson enum string( optional ) whether a related person to the investor or investor themselves, values âyesâ / ânoâ â relatedpersontype enum string( optional ) type of related person, values â1â / â2â / â3â for âguardian of a minorâ, âassigneeâ, and âauthorised representativeâ respectively, required if the related person is applicable (relatedperson is âyesâ) â relatedpersonkycnumberexists enum string( optional ) whether related person has a kyc number, values âyesâ/ânoâ, required if related person is applicable (relatedperson is âyesâ) â relatedpersonkycnumber string ( optional ), valid kyc number kyc number of related person ( required if relatedpersonkycnumberexists is âyesâ) â relatedpersontitle string related person title, values âmr â/ âmrs â / âms â / âmx â, required if related person is applicable (relatedperson is âyesâ) â relatedpersonname string name of related person, required if related person is applicable (relatedperson is âyesâ) â relatedpersonidentityproof object required if related person is applicable(relatedperson is âyesâ), see below for details â relatedpersonidentityprooftype enum string( optional ) type of related persons id proof, values âindividualpanâ/âaadhaarâ/âpassportâ/âdrivinglicenceâ/âvoterid, required if related person is applicable (relatedperson is âyesâ) relatedpersonidentityproof object details when related personâs poi is pan 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 relatedpersonidentityproof object details when related personâs poi is aadhaar 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 relatedpersonidentityproof object details when related personâs poi is passport 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 relatedpersonidentityproof object details when related personâs poi is driving license 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 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 relatedpersonidentityproof object details when related personâs poi is voterid 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 expected output { "object" "updated successfully" } 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