Skip to content

KRA (Identity Registry) — Fields consumed

Why this page is structured this way: This is the destination-first view for KRA (Identity Registry). Engineers building an integration with this destination get the complete field list on one page. To see where each field originated in onboarding, follow the per-section links via the atlas overview.

  • 124 unique fields consumed by KRA (Identity Registry).
  • Source spans sections: A, B, C, D, E, F, G, J, K, S.
  • 50 rows cite a public spec source; 74 are [industry typical].

Sorted by source_section, then field_id.

source_sectionfield_idfield_namedestination_field_namedestination_formatfrequencytransformationquirks_notesspec_source
AA-aadhaar_numberAadhaar NumberAADHAAR_REFVARCHAR(28)on-modifyderived from YKRA does not store full Aadhaar; only masked reference or VIDSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
AA-aadhaar_reference_numberAadhaar Reference (VID)AADHAAR_VIDVARCHAR(28)on-modify[direct]Virtual ID or DigiLocker reference; used in lieu of Aadhaar[industry typical]
AA-ckyc_numberCKYC Identification NumberCKYC_NOCHAR(14)on-modify[direct]KRA stores KIN as reference; masked in API responses post Jan 2025SEBI/HO/MIRSD/SECFATF/P/CIR/2024/79
AA-country_of_birthCountry of BirthCTRY_OF_BIRTHCHAR(2)on-modifylookup against RISO 3166-1 alpha-2; FATCA-mandatory field centralized at KRA since 01-Jul-2024SEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
AA-date_of_birthDate of BirthDOBDATE DD/MM/YYYYon-modifyformattedMust match PAN ITD record; KRA rejects on mismatch via 3-param validationSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
AA-dinDirector Identification NumberDINCHAR(8)on-modify[direct]Optional; applicable only if customer is a director[industry typical]
AA-disability_percentageDisability PercentageDISABILITY_PCTNUMBER(3)on-modify[direct]0-100; conditional[industry typical]
AA-disability_typeDisability TypeDISABILITY_TYPECHAR(2)on-modifylookup against RConditional on is_differently_abled=Y[industry typical]
AA-father_spouse_flagFather/Spouse IndicatorFATHER_SPOUSE_FLAGCHAR(1)on-modify[direct]F=Father, S=Spouse; controls which name is captured[industry typical]
AA-father_spouse_nameFather/Spouse NameFATHER_SPOUSE_NAMEVARCHAR(140)on-modifyformattedKRA stores as single concatenated string; uppercase preferred[industry typical]
AA-father_spouse_prefixFather/Spouse PrefixFATH_SPOUSE_PREFIXVARCHAR(5)on-modify[direct]Mr/Mrs/Ms based on relationship[industry typical]
AA-first_nameFirst NameFIRST_NAMEVARCHAR(70)on-modifyformattedMust match PAN-card name exactly; KRA rejects on character-level mismatchSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
AA-full_nameFull NameFULL_NAMEVARCHAR(200)on-modifyderived from YDerived from prefix+first+middle+last; some KRAs reject if mismatch with PAN ITD nameSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
AA-genderGenderGENDERCHAR(1)on-modify[direct]M=Male, F=Female, T=Transgender[industry typical]
AA-is_differently_abledDifferently Abled StatusDIFF_ABLED_FLAGCHAR(1)on-modify[direct]Y/N; KRA template typically follows CKYC field[industry typical]
AA-last_nameLast NameLAST_NAMEVARCHAR(70)on-modifyformattedMust match PAN; rejection codes include name-mismatch classSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
AA-maiden_first_nameMaiden First NameMAIDEN_FIRST_NAMEVARCHAR(70)on-modifyformattedOptional in KRA template; populated for name-change cases[industry typical]
AA-maiden_last_nameMaiden Last Name[same]VARCHAR(70)on-modifyformattedOptional[industry typical]
AA-maiden_middle_nameMaiden Middle Name[same]VARCHAR(70)on-modifyformattedOptional[industry typical]
AA-maiden_prefixMaiden Prefix[same]VARCHAR(5)on-modify[direct]Optional; only if name changed after marriage[industry typical]
AA-marital_statusMarital StatusMARITAL_STATUSCHAR(1)on-modify[direct]S=Single, M=Married, O=Others[industry typical]
AA-middle_nameMiddle NameMIDDLE_NAMEVARCHAR(70)on-modifyformattedOptional; if present must match PAN[industry typical]
AA-mother_nameMother NameMOTHER_NAMEVARCHAR(70)on-modifyformattedOptional[industry typical]
AA-mother_prefixMother PrefixMOTHER_PREFIXVARCHAR(5)on-modify[direct]Optional in KRA[industry typical]
AA-nationalityNationalityNATIONALITYCHAR(2)on-modifylookup against RISO 3166-1 alpha-2; IN=Indian default[industry typical]
AA-pan_exemptPAN Exempt FlagPAN_EXEMPTCHAR(1)on-modify[direct]Y/N flag for specific govt categories; rare in broking[industry typical]
AA-pan_exempt_categoryPAN Exempt CategoryPAN_EXEMPT_CATGCHAR(2)on-modifylookup against RRequired if pan_exempt=Y; code table maintained by intermediary[industry typical]
AA-pan_numberPAN NumberPAN_NOCHAR(10)on-modifyuppercaseValidated 3-param (PAN+Name+DOB) against Protean; alphanumeric, 4th char P=Individual; rejection if mismatchSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
AA-photographCustomer PhotographPHOTOBLOBon-modify[direct]Passport-size, recent, colour, max 1MB[industry typical]
AA-place_of_birthPlace of BirthPLACE_OF_BIRTHVARCHAR(50)on-modifyformattedOptional in KRA; required for FATCA cross-checkSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
AA-prefixName PrefixPREFIXVARCHAR(5)on-modify[direct]Mr/Mrs/Ms/Dr; KRA template accepts as separate token[industry typical]
AA-residential_statusResidential StatusRESI_STATUSCHAR(2)on-modify[direct]RI/NRI/FN/PIO; KRA accepts via 2024 master KYC circularSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
AA-signatureCustomer SignatureSIGNATUREBLOBon-modify[direct]White background; JPEG/PNG max 500KB[industry typical]
AA-udid_numberUDID NumberUDIDVARCHAR(18)on-modifyuppercaseFormat [A-Z]{2}\d{16}[industry typical]
BB-corr_address_line1Correspondence Address Line 1CORR_ADDR_L1VARCHAR(100)on-modify[direct]Mandatory; KRA validates against POA documentSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
BB-corr_address_line2Correspondence Address Line 2CORR_ADDR_L2VARCHAR(100)on-modify[direct]Optional[industry typical]
BB-corr_address_line3Correspondence Address Line 3CORR_ADDR_L3VARCHAR(100)on-modify[direct]Optional[industry typical]
BB-corr_address_proof_typeCorrespondence Address Proof TypeCORR_POA_TYPECHAR(2)on-modifylookup against RPOA code table A-Z; KRA validates document validitySEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
BB-corr_cityCorrespondence CityCORR_CITYVARCHAR(50)on-modifyformattedMandatory[industry typical]
BB-corr_countryCorrespondence CountryCORR_COUNTRYCHAR(2)on-modifylookup against RISO alpha-2; default IN[industry typical]
BB-corr_districtCorrespondence DistrictCORR_DISTRICTVARCHAR(50)on-modifyformattedOptional in KRA[industry typical]
BB-corr_pincodeCorrespondence PincodeCORR_PINCODECHAR(6)on-modify[direct]6 digits for India[industry typical]
BB-corr_stateCorrespondence StateCORR_STATECHAR(2)on-modifylookup against R2-letter state code per Appendix A[industry typical]
BB-perm_address_line1Permanent Address Line 1PERM_ADDR_L1VARCHAR(100)on-modify[direct]Conditional; required if perm_same_as_corr=N[industry typical]
BB-perm_address_line2Permanent Address Line 2PERM_ADDR_L2VARCHAR(100)on-modify[direct]Conditional[industry typical]
BB-perm_address_line3Permanent Address Line 3PERM_ADDR_L3VARCHAR(100)on-modify[direct]Conditional[industry typical]
BB-perm_address_proof_typePermanent Address Proof TypePERM_POA_TYPECHAR(2)on-modifylookup against RConditional; POA code[industry typical]
BB-perm_cityPermanent CityPERM_CITYVARCHAR(50)on-modifyformattedConditional[industry typical]
BB-perm_countryPermanent CountryPERM_COUNTRYCHAR(2)on-modifylookup against RConditional; ISO alpha-2[industry typical]
BB-perm_districtPermanent DistrictPERM_DISTRICTVARCHAR(50)on-modifyformattedOptional[industry typical]
BB-perm_pincodePermanent PincodePERM_PINCODECHAR(6)on-modify[direct]Conditional[industry typical]
BB-perm_same_as_corrPermanent Same as CorrespondencePERM_SAME_FLAGCHAR(1)on-modify[direct]If Y, KRA omits permanent section[industry typical]
BB-perm_statePermanent StatePERM_STATECHAR(2)on-modifylookup against RConditional[industry typical]
CC-alternate_emailAlternate EmailALT_EMAILVARCHAR(100)on-modifylowercaseOptional[industry typical]
CC-alternate_mobileAlternate MobileALT_MOBILEVARCHAR(15)on-modify[direct]Optional; not validated[industry typical]
CC-emailEmail AddressEMAILVARCHAR(100)on-modifylowercaseKRA validates via email link; kra_email_validated flag setSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
CC-fax_numberFax NumberFAX_NOVARCHAR(15)on-modify[direct]Rarely populated[industry typical]
CC-fax_std_codeFax STD CodeFAX_STDVARCHAR(5)on-modify[direct]Rarely populated[industry typical]
CC-mobile_isd_codeMobile ISD CodeMOB_ISDVARCHAR(5)on-modify[direct]Default +91; KRA stores ISD separately for mobile and phone[industry typical]
CC-mobile_numberMobile NumberMOBILE_NOVARCHAR(15)on-modify[direct]KRA validates mobile via OTP; flag kra_mobile_validated set on successSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
CC-phone_numberPhone NumberPHONE_NOVARCHAR(15)on-modify[direct]Landline; optional[industry typical]
CC-phone_std_codePhone STD CodePHONE_STDVARCHAR(5)on-modify[direct]Landline STD; optional[industry typical]
DD-poi_document_imagePOI Document ImagePOI_IMAGEBLOBon-modify[direct]KRA stores scanned doc; JPEG/PNG/PDF max 2MB[industry typical]
DD-poi_document_numberPOI Document NumberPOI_DOC_NOVARCHAR(30)on-modifyuppercaseFormat depends on poi_type; PAN [A-Z]{5}\d{4}[A-Z][industry typical]
DD-poi_expiry_datePOI Expiry DatePOI_EXPIRY_DATEDATE DD/MM/YYYYon-modifyformattedConditional for Passport, DL[industry typical]
DD-poi_issue_datePOI Issue DatePOI_ISSUE_DATEDATE DD/MM/YYYYon-modifyformattedOptional[industry typical]
DD-poi_issuing_authorityPOI Issuing AuthorityPOI_ISSUE_AUTHVARCHAR(50)on-modifyformattedOptional[industry typical]
DD-poi_typePOI TypePOI_TYPECHAR(2)on-modifylookup against RPOI code table A-Z per Appendix A2[industry typical]
DD-poi_verified_from_issuerPOI Verified FlagPOI_VERIFIEDCHAR(1)on-modify[direct]Y/N; KRA cross-references with verification sourceSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
EE-poa_address_same_as_corrPOA Address Same as CorrespondencePOA_ADDR_SAMECHAR(1)on-modify[direct]If N, KRA records discrepancy reason[industry typical]
EE-poa_document_imagePOA Document ImagePOA_IMAGEBLOBon-modify[direct]JPEG/PNG/PDF max 2MB[industry typical]
EE-poa_document_numberPOA Document NumberPOA_DOC_NOVARCHAR(30)on-modifyuppercaseFormat depends on POA type[industry typical]
EE-poa_expiry_datePOA Expiry DatePOA_EXPIRY_DATEDATE DD/MM/YYYYon-modifyformattedConditional for Passport, DL[industry typical]
EE-poa_issue_datePOA Issue DatePOA_ISSUE_DATEDATE DD/MM/YYYYon-modifyformattedOptional[industry typical]
EE-poa_typePOA TypePOA_TYPECHAR(2)on-modifylookup against RPOA code table A-Z per Appendix A3[industry typical]
EE-poa_verified_from_issuerPOA Verified FlagPOA_VERIFIEDCHAR(1)on-modify[direct]Y/N; mandatorySEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
FF-declared_annual_incomeDeclared Annual IncomeANN_INCOME_AMTNUMBER(15,2)on-modify[direct]Optional; INR exact[industry typical]
FF-gross_annual_income_rangeGross Annual Income RangeINCOME_SLABCHAR(2)on-modifylookup against RIncome range code 01-06; SEBI proposed revised slabs Jan 2026[industry typical]
FF-net_worthNet WorthNET_WORTHNUMBER(15,2)on-modify[direct]INR Lakhs; KRA optional[industry typical]
FF-net_worth_dateNet Worth DateNET_WORTH_DATEDATE DD/MM/YYYYon-modifyformattedConditional; must be <1 year old[industry typical]
FF-occupationOccupationOCCUPATIONCHAR(2)on-modifylookup against RKRA/CKYC shared occupation code table (01-11, 99)SEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
FF-occupation_othersOccupation OthersOCCUPATION_OTHERSVARCHAR(50)on-modifyformattedConditional if F01=99[industry typical]
FF-source_of_wealthSource of WealthSRC_OF_WEALTHVARCHAR(100)on-modifyformattedOptional in KRA; required for high-net-worth EDDSEBI/HO/MIRSD/SECFATF/P/CIR/2024/78
GG-account_holder_nameAccount Holder NameBANK_ACCT_HOLDERVARCHAR(100)on-modifyformattedMust match PAN name; verified via penny dropSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
GG-account_numberBank Account NumberBANK_ACCT_NOVARCHAR(18)on-modify[direct]Alphanumeric; KRA stores masked except last 4[industry typical]
GG-account_typeBank Account TypeBANK_ACCT_TYPECHAR(2)on-modify[direct]SB/CA/NRE/NRO[industry typical]
GG-bank_nameBank NameBANK_NAMEVARCHAR(100)on-modifyformattedKRA primary bank only; multi-bank stored locally only[industry typical]
GG-branch_nameBranch NameBANK_BRANCHVARCHAR(100)on-modifyformattedOptional[industry typical]
GG-ifsc_codeIFSC CodeIFSCCHAR(11)on-modifyuppercaseFormat [A-Z]{4}0[A-Z0-9]{6}[industry typical]
GG-micr_codeMICR CodeMICRVARCHAR(9)on-modify[direct]9 digits; optional[industry typical]
JJ-citizenship_countryCitizenship CountryCITIZENSHIPCHAR(2)on-modifylookup against RISO alpha-2; supports multiple per repeat groupSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-country_of_birthCountry of Birth (FATCA)FATCA_CTRY_BIRTHCHAR(2)on-modifylookup against RISO alpha-2; FATCA-mandatedSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-fatca_declaration_dateFATCA Declaration DateFATCA_DECL_DATEDATE DD/MM/YYYYon-modifyformattedMandatory; date of self-certificationSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-fatca_declaration_placeFATCA Declaration PlaceFATCA_DECL_PLACEVARCHAR(50)on-modifyformattedCity of declarationSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-fatca_signatureFATCA SignatureFATCA_SIGNBLOBon-modify[direct]Digital or scanned; centralized at KRASEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-is_tax_resident_of_india_onlyTax Resident India OnlyTAX_RES_INDIA_ONLYCHAR(1)on-modify[direct]Y/N; centralized at KRA since 01-Jul-2024; KRA stores FATCA self-certSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-is_us_personUS Person FlagUS_PERSON_FLAGCHAR(1)on-modify[direct]Y/N; triggers FATCA reporting if YSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-place_of_birth_cityPlace of Birth CityFATCA_POB_CITYVARCHAR(50)on-modifyformattedFATCA mandatorySEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-tax_countryTax Residency CountryTAX_COUNTRYCHAR(2)on-modifylookup against RRepeats up to 5 countries; KRA centralization since 01-Jul-2024SEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-tax_id_numberTax ID NumberTAX_TINVARCHAR(30)on-modify[direct]TIN for each tax countrySEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-tax_id_typeTax ID TypeTIN_TYPECHAR(2)on-modify[direct]TIN/SSN/EIN etcSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-tin_not_available_reasonTIN Not Available ReasonTIN_NA_REASONCHAR(1)on-modify[direct]A=Country doesn’t issue, B=Unable, C=Not requiredSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-us_green_card_holderUS Green Card HolderUS_GREEN_CARDCHAR(1)on-modify[direct]Conditional; affects FATCA reporting classSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
JJ-us_tin_ssnUS TIN/SSNUS_TINVARCHAR(11)on-modify[direct]Conditional if is_us_person=YSEBI/HO/MIRSD/SECFATF/P/CIR/2024/12
KK-beneficial_owner_declarationBeneficial Owner DeclarationBO_DECLARATIONCHAR(1)on-modify[direct]Y if acting for self; PMLA Rule 9 lowered BO threshold per 2023 amendmentSEBI/HO/MIRSD/SECFATF/P/CIR/2024/78
KK-beneficial_owner_detailsBeneficial Owner DetailsBO_DETAILSVARCHAR(500)on-modifyformattedConditional if BO declaration=N; details of actual BOSEBI/HO/MIRSD/SECFATF/P/CIR/2024/78
KK-is_pepPEP FlagPEP_FLAGCHAR(1)on-modify[direct]Y/N; triggers EDD; KRA-stored per AML master circularSEBI/HO/MIRSD/SECFATF/P/CIR/2024/78
KK-is_pep_relatedPEP-Related FlagPEP_RELATEDCHAR(1)on-modify[direct]Related to a PEP; same EDD triggerSEBI/HO/MIRSD/SECFATF/P/CIR/2024/78
KK-pep_detailsPEP DetailsPEP_DETAILSVARCHAR(200)on-modifyformattedConditional; name, designation, relationshipSEBI/HO/MIRSD/SECFATF/P/CIR/2024/78
KK-source_of_fundsSource of FundsSRC_OF_FUNDSVARCHAR(100)on-modifyformattedSalary/Business/Investments/Inheritance/Gift/OthersSEBI/HO/MIRSD/SECFATF/P/CIR/2024/78
SS-kra_app_numberKRA Application NumberAPP_NOVARCHAR(30)one-time[direct]Unique application reference; shared across 5 KRAs via interoperabilitySEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
SS-kra_app_typeKRA Application TypeAPP_TYPECHAR(2)one-time[direct]IN=Individual[industry typical]
SS-kra_kyc_dateKRA KYC DateKYC_DATEDATE DD/MM/YYYYone-timeformattedDate of original KYC captureSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
SS-kra_pos_codeKRA POS CodePOS_CODEVARCHAR(20)one-time[direct]Intermediary Point of Service code assigned by KRA[industry typical]
SS-kra_rejection_reasonKRA Rejection ReasonREJECTION_REASONVARCHAR(200)on-eventformattedFree text from KRA if rejected; common: name mismatch, image qualitySEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
SS-kra_submission_dateKRA Submission DateSUBMISSION_DATEDATETIME ISO 8601one-timeformattedUpload within 3 working days of KYC completionSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
SS-kra_submission_responseKRA Submission ResponseRESPONSE_JSONJSONon-event[direct]Full payload from KRA API; stored for audit[industry typical]
SS-kra_submission_statusKRA Submission StatusSUBMISSION_STATUSCHAR(2)on-event[direct]SU/AC/RJ; KRA validates within 2 working daysSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
SS-kra_validation_dateKRA Validation DateVALIDATION_DATEDATETIME ISO 8601on-eventformattedDate when KRA completed validationSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
SS-kra_validation_statusKRA Validation StatusVALIDATION_STATUSVARCHAR(20)on-eventlookup against RStatus codes per Appendix A4: KYC Registered, On Hold, Rejected, etcSEBI/HO/MIRSD/SECFATF/P/CIR/2024/41
SS-kra_verification_dateKRA Verification DateVERIFICATION_DATEDATE DD/MM/YYYYone-timeformattedDate of intermediary verification of documentsSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
SS-kra_verifier_designationKRA Verifier DesignationVERIFIER_DESIGVARCHAR(50)one-timeformattedDesignation of authorized personSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
SS-kra_verifier_nameKRA Verifier NameVERIFIER_NAMEVARCHAR(100)one-timeformattedPerson who verified KYC at intermediarySEBI/HO/MIRSD/SECFATF/P/CIR/2023/169
SS-kra_verifier_organizationKRA Verifier OrganizationVERIFIER_ORGVARCHAR(100)one-timeformattedIntermediary nameSEBI/HO/MIRSD/SECFATF/P/CIR/2023/169

2026-05-14


AI-generated and not legal advice. See the project README for full disclaimer.