DigiLocker UIStreams

Why are DigiLocker UIStreams needed?

DigiLocker UIStreams allow you to seamlessly integrate with all DigiLocker document retrieval workflows bundled into a single API. Just use the prefix DIGILOCKER and the name of the document you want to retrieve from your user and you are done!

The UIStream takes care of all of the following steps:

Make sure that the best and easiest login screen with the least friction and highest conversion rate is shown to the end customer so that there are minimal drop-offs when the user signs in.
Multi-lingual capabilities with on-the-fly translation to cater to audiences who are not familiar with English.
Automatic checking of wallet for existing documents and automatic isolation of consents to only the documents you want to retrieve from the customer.
Pull documents from issuers directly on the UIStream which manages real-time form rendering of all organizations, documents, and document parameters in the entire DigiLocker ecosystem.

Supported DigiLocker Flows

The following is a list of DigiLocker UIStreams that are currently live in the production environment:

UIStream Name	Document Collected	Digital Use Case Examples	Real-World Conversion
`DIGILOCKER_AADHAAR`	Aadhaar Card	KYC, Address Verification in journeys for CRED, Bajaj Finserv, AU Small Finance Bank, Kotak Mahindra Bank	⭐⭐⭐⭐⭐
`DIGILOCKER_AADHAAR_PAN`	Aadhaar + PAN	Financial KYC for loan applications with CRED, Flipkart, ICICI Bank, Razorpay, Slice	⭐⭐⭐⭐⭐
`DIGILOCKER_PAN_CERTIFICATE`	PAN Card	Tax Filing and Financial Onboarding for Paytm, Zerodha, HDFC Bank, Axis Bank	⭐⭐⭐⭐⭐
`DIGILOCKER_VEHICLE_REGISTRATION_CERTIFICATE`	Vehicle Registration Certificate (RC)	Car Purchase, Vehicle Verification for Zoomcar, CARS24, OLX Autos, Spinny	⭐⭐⭐⭐
`DIGILOCKER_DRIVING_LICENSE`	Driving License	License Verification, Insurance Claims for Acko, Digit Insurance, Tata AIG, Bajaj Allianz	⭐⭐⭐⭐
`DIGILOCKER_TWO_WHEELER_INSURANCE_POLICY`	Two-Wheeler Insurance Policy	Insurance for two-wheeler loans with L&T Finance, Hero Fincorp, HDFC Ergo	⭐⭐⭐⭐
`DIGILOCKER_LIFE_INSURANCE_POLICY`	Life Insurance Policy	Life insurance verification for PolicyBazaar, ICICI Prudential, Max Life Insurance	⭐⭐⭐
`DIGILOCKER_HEALTH_INSURANCE_POLICY`	Health Insurance Policy	Health insurance verification for Star Health, Apollo Munich, Niva Bupa	⭐⭐⭐
`DIGILOCKER_CLASS_X_MARKSHEET`	Class X Marksheet	School Admission, Education Loan for Byju’s, FIITJEE, State Bank of India, Axis Bank	⭐⭐⭐⭐
`DIGILOCKER_CLASS_X_LEAVING_CERTIFICATE`	Class X Leaving Certificate	School Transfer Verification for Allen Career Institute, Kendriya Vidyalaya	⭐⭐⭐
`DIGILOCKER_CLASS_X_PROVISIONAL_CERTIFICATE`	Class X Provisional Certificate	College Admission for Narayana Institute, Christ University, SRM University	⭐⭐⭐
`DIGILOCKER_CLASS_X_PASSING_CERTIFICATE`	Class X Passing Certificate	School Verification, College Admission for NIIT, Techno India, Amity University	⭐⭐⭐
`DIGILOCKER_CLASS_XII_MARKSHEET`	Class XII Marksheet	College Admission, Job Application for Infosys, Wipro, Indian Army, Flipkart	⭐⭐⭐
`DIGILOCKER_CLASS_XII_PASSING_CERTIFICATE`	Class XII Passing Certificate	College Admission for BITS Pilani, Manipal University, Lovely Professional University	⭐⭐⭐
`DIGILOCKER_DEGREE_MARKSHEET`	Degree Marksheet	Higher Education, Job Application for TCS, Infosys, Google, Cognizant	⭐⭐
`DIGILOCKER_DEGREE_CERTIFICATE`	Degree Certificate	Higher Education, Job Application for Capgemini, Accenture, IBM	⭐⭐
`DIGILOCKER_PROVISIONAL_DEGREE_CERTIFICATE`	Provisional Degree Certificate	Job Application, Further Studies for Mindtree, Infosys, Hexaware	⭐⭐
`DIGILOCKER_PENSION_COMMUTATION_PAYMENT_ORDER`	Pension Commutation Payment Order	Pension Verification for LIC, PNB MetLife, HDFC Pension	⭐⭐⭐
`DIGILOCKER_PENSION_CERTIFICATE`	Pension Certificate	Pension Claims for EPFO, LIC Pension Funds	⭐⭐⭐
`DIGILOCKER_ELIGIBILITY_CERTIFICATE`	Eligibility Certificate	Scholarship Application for Vidya Lakshmi, Tata Trusts, SBI Education Loan	⭐⭐⭐
`DIGILOCKER_MIGRATION_CERTIFICATE`	Migration Certificate	School/College Transfer for DU, Mumbai University, Pune University	⭐⭐⭐
`DIGILOCKER_ADMIT_CARD`	Admit Card	Exam Verification for CBSE, SSC, UPSC	⭐⭐⭐
`DIGILOCKER_UNIVERSITY_TRANSCRIPT`	University Transcript	Higher Studies Abroad, Employment Verification for WES, IQAS, Narsee Monjee Institute	⭐⭐
`DIGILOCKER_DIPLOMA_CERTIFICATE`	Diploma Certificate	Job Application, Further Studies for L&T, Siemens, Blue Star	⭐⭐
`DIGILOCKER_DEGREE_DIPLOMA_MARKSHEET`	Diploma Marksheet	Job Application, Higher Studies for Indian Institute of Technology (IIT), National Institute of Technology (NIT)	⭐⭐
`DIGILOCKER_SKILL_CERTIFICATE`	Skill Certificate	Job Application, Skill Verification for National Skill Development Corporation (NSDC), UrbanClap, Tata Strive	⭐⭐⭐
`DIGILOCKER_COURSE_COMPLETION_CERTIFICATE`	Course Completion Certificate	Course Verification for Udemy, Coursera, LinkedIn Learning	⭐⭐⭐
`DIGILOCKER_EQUIVALENCE_CERTIFICATE`	Equivalence Certificate	Qualification Verification for Ministry of Education, Narsee Monjee Institute of Management Studies (NMIMS), University Grants Commission (UGC)	⭐⭐⭐
`DIGILOCKER_CLASS_XII_LEAVING_CERTIFICATE`	Class XII Leaving Certificate	College Transfer, Admission for Delhi University, Symbiosis, Amity	⭐⭐⭐
`DIGILOCKER_CLASS_X_MERIT_CERTIFICATE`	Class X Merit Certificate	Merit-Based Scholarship for Central Government Scholarships, Vidya Lakshmi, SBI Education Loans	⭐⭐⭐
`DIGILOCKER_CLASS_XII_COMPARTMENT_MARKSHEET`	Class XII Compartment Marksheet	Re-Examination Verification for CBSE, NCERT, National Institute of Open Schooling (NIOS)	⭐⭐
`DIGILOCKER_PROVISIONAL_CERTIFICATE`	Provisional Certificate	Further Studies, Job Application for Tata Consultancy Services, HCL Technologies, Infosys	⭐⭐⭐
`DIGILOCKER_PASSING_CERTIFICATE`	Passing Certificate	Qualification Verification for Accenture, IBM, Cognizant	⭐⭐⭐
`DIGILOCKER_SCHOOL_LEAVING_CERTIFICATE`	School Leaving Certificate	School Transfer for CBSE, ICSE, Kendriya Vidyalaya Sangathan	⭐⭐⭐

Brief Explanation of the Payload Sent to `callback_url`

The payload represents a structured response containing details about the successful retrieval of user documents via the uistream callback. Below is a breakdown of its key components:

High-Level Information

Key	Value (Masked)
`initialDecentroTxnId`	`**************6813`
`status`	`SUCCESS`
`message`	`All documents have been fetched successfully.`
`responseKey`	`success_uistream_documents_fetch`

Document Details in `data`

EAADHAAR: Contains Aadhaar-related information retrieved from Digilocker.
Transaction Details:

Key	Value (Masked)
`decentroTxnId`	`**************B73`
`status`	`SUCCESS`
`responseCode`	`S00000`
`message`	`E-Aadhaar information received successfully from Digilocker`

Aadhaar Details:

Key	Value (Masked)
`aadhaarUid`	`********2661`
`proofOfIdentity`	Contains details such as DOB (`DD-MM-YYYY`), gender (`M`), and name.
`proofOfAddress`	Includes address fields like house number, pincode, and locality.

Document Media: Base64-encoded versions of the Aadhaar image, PDF, and XML.

ISSUED_FILES: Lists additional retrieved documents.
- Items:
Document Name Document Type Issuer
Aadhaar Card ADHAR UIDAI
PAN Verification Record PANCR Income Tax Department
PAN: Contains details about the user's PAN card.
PAN Details:

Document Name	Document Type	Issuer
Aadhaar Card	`ADHAR`	UIDAI
PAN Verification Record	`PANCR`	Income Tax Department

Key	Value
`idNumber`	`BDABJ1234J`
`userName`	`John Doe`
`userDateOfBirth`	`DD-MM-YYYY`
`userGender`	`MALE`
`documentVerifiedOn`	`DD-MM-YYYY`
`documentStatus`	`Active`

Document Media: Base64-encoded file (masked).

Full Payload Sample

{
    "initialDecentroTxnId": "**************6813",
    "status": "SUCCESS",
    "message": "All documents have been fetched successfully.",
    "responseKey": "success_uistream_documents_fetch",
    "data": {
        "EAADHAAR": {
            "decentroTxnId": "**************B73",
            "status": "SUCCESS",
            "responseCode": "S00000",
            "message": "E-Aadhaar information received successfully from Digilocker",
            "data": {
                "aadhaarReferenceNumber": "",
                "aadhaarUid": "********1234",
                "proofOfIdentity": {
                    "dob": "DD-MM-YYYY",
                    "hashedEmail": "",
                    "gender": "M",
                    "hashedMobileNumber": "",
                    "name": "**** ****"
                },
                "proofOfAddress": {
                    "careOf": "S/O **** ****",
                    "country": "India",
                    "district": "******",
                    "house": "***",
                    "landmark": "Beside ****",
                    "locality": "*********",
                    "pincode": "******",
                    "postOffice": "********",
                    "state": "**********",
                    "street": "**** Main, ********** Road",
                    "subDistrict": "",
                    "vtc": "******"
                },
                "image": "BASE64",
                "pdf": "BASE64",
                "xml": "BASE64"
            },
            "responseKey": "success_eaadhaar_download"
        },
        "ISSUED_FILES": {
            "items": [
                {
                    "name": "Aadhaar Card",
                    "type": "file",
                    "size": "",
                    "date": "**-**-2024",
                    "parent": "",
                    "mime": [
                        "application/json",
                        "application/xml",
                        "application/pdf"
                    ],
                    "uri": "in.gov.uidai-ADHAR-************",
                    "doctype": "ADHAR",
                    "description": "Aadhaar Card",
                    "issuerid": "in.gov.uidai",
                    "issuer": "Unique Identification Authority of India (UIDAI)"
                },
                {
                    "name": "PAN Verification Record",
                    "type": "file",
                    "size": "",
                    "date": "**-**-2024",
                    "parent": "",
                    "mime": [
                        "application/json",
                        "application/xml",
                        "application/pdf"
                    ],
                    "uri": "in.gov.pan-PANCR-************",
                    "doctype": "PANCR",
                    "description": "PAN Verification Record",
                    "issuerid": "in.gov.pan",
                    "issuer": "Income Tax Department"
                }
            ]
        },
        "PAN": {
            "documentIssuer": "Income Tax Department",
            "documentName": "PAN Verification Record",
            "documentType": "PANCR",
            "idNumber": "**********6J",
            "userName": "**** ****",
            "userDateOfBirth": "**-**-1998",
            "userGender": "MALE",
            "documentVerifiedOn": "**-**-2024",
            "documentStatus": "Active",
            "documentBase64": "BASE64"
        }
    }
}