Aadhaar Bank Account Seeding Status API Check Aadhaar-to-Bank Account Seeding Status
Verify whether an Aadhaar number is seeded or mapped to a bank account and retrieve the available status information for digital payments, DBT, banking, lending, and financial-service workflows.
End-to-End Flow
Submit Aadhaar Details
Validate the Request
Check Aadhaar Mapping
Identify Seeding Status
Retrieve Bank Information
Generate Verification Result
Use the Result
Key Capabilities
Aadhaar Seeding Status
Check whether an Aadhaar number is seeded or mapped to a bank account.
NPCI Mapping Status
Support status checks relating to Aadhaar mapping in the NPCI mapper. NPCI documents statuses including Active, Inactive, Invalid, and Not Present.
Bank Linkage Information
Retrieve available information regarding the bank associated with the Aadhaar mapping, subject to the supported response.
DBT Readiness
Use Aadhaar-bank linkage information as part of workflows involving Direct Benefit Transfer.
Unlinked Account Detection
Identify cases where Aadhaar is not present in the relevant mapping system before initiating dependent workflows.
Digital Verification
Support paperless, API-driven seeding-status checks. The referenced API describes consent-based/offline verification approaches for this purpose.
Structured Response
Receive machine-readable seeding information that can be integrated into enterprise applications.
Use Cases
Banking & Financial Institutions
Banks and financial institutions can incorporate Aadhaar seeding checks into account and customer workflows.
Lending & Financial Services
Use Aadhaar-bank linkage information as an additional check within financial workflows.
DBT & Government Benefit Workflows
Aadhaar-bank mapping is relevant to benefit-transfer workflows. NPCI's documentation describes BASE functionality for checking Aadhaar seeding status and managing Aadhaar seeding.
Developer Experience
Simple Input. Structured Seeding Status.
Suggested Input
{
"aadhaar_number": "XXXXXXXX1234",
"consent": true
}Suggested Output
{
"client_id": "FINXXXXXX",
"aadhaar_number": "XXXX-XXXX-1234",
"seeding_status": "ACTIVE",
"bank_name": "XXXXXXXX BANK",
"verification_status": "VERIFIED"
}Possible Status Values
Depending on the implementation, status values can represent states such as:
-
Active
-
Inactive
-
Invalid
-
Not Present
These status categories are documented by NPCI for Aadhaar mapper lookup.
Important: Use the exact FinAnalyz production request and response fields in the final API documentation. Don’t publish the example schema above as the actual API contract unless those fields match your implementation.
Related APIs
Frequently Asked Questions
What is an Aadhaar Bank Account Seeding Status API?
It is an API that helps businesses check whether an Aadhaar number is linked or mapped to a bank account and retrieve the applicable seeding status.
What does Aadhaar seeding mean?
Aadhaar seeding refers to linking an Aadhaar number with a customer's bank account in the bank's systems and, where applicable, mapping it through the NPCI system for relevant services. NPCI specifically notes that updating Aadhaar in a bank's CBS does not by itself mean that NPCI mapping is complete.
What seeding statuses can be identified?
NPCI documentation identifies mapping states including: Active Inactive Invalid Not Present
Why is Aadhaar-bank seeding important?
Aadhaar-bank mapping is relevant to workflows involving DBT and Aadhaar-enabled financial services. NPCI's BASE platform provides functionality for checking Aadhaar seeding status and managing seeding.
Can the API identify the linked bank?
Where supported by the implementation and response, the API can provide information about the bank associated with the Aadhaar mapping. The exact response should follow the FinAnalyz API specification.
Can this API be used for DBT workflows?
Yes. Aadhaar-bank mapping is directly relevant to DBT-related workflows, and NPCI documentation describes the role of Aadhaar mapping in routing benefits and subsidies.
Is Aadhaar seeding the same as PAN-Aadhaar linking?
No. Aadhaar Bank Account Seeding → Aadhaar linked/mapped with a bank account. PAN-Aadhaar Linking → PAN linked with Aadhaar for tax-related identity linkage. These should be treated as separate verification APIs.
Is Aadhaar seeding status the same as bank-account verification?
No. Bank Account Verification API → Focuses on validating bank-account information. Aadhaar Bank Account Seeding Status API → Focuses specifically on the Aadhaar-to-bank-account seeding/mapping status.
Still have any question? Please contact our sales team
Integrate FinAnalyz APIs into your workflows and access structured data, verification, and analytics through a simple, developer-friendly integration.