Mobile to X Suite
Overview
The Mobile to X API suite is designed to make alternative data aggregation seamless by using a person’s mobile number to retrieve various important datasets.
This API enables seamless access to alternative data sources, providing vital information such as name, Udyam number, UPI VPA, and UAN linked to a mobile number.
By facilitating these data points, the Mobile to X APIs empower financial institutions to enhance customer onboarding, verification, and overall decision-making and underwriting processes for various financial instruments such as loans and insurance.
Key Features:
- Retrieve details like name, Udyam number, UPI VPA, and UAN.
- Built for use cases in finance, banking, and alternative data aggregation.
- Fast, reliable, and secure API integration for real-time data retrieval.
Insights into Use Cases
1. Financial Inclusion and Credit Scoring
Lenders can use Mobile to X to quickly verify business registration details (Udyam number) or UPI VPAs to assess financial credibility. This aids in credit risk analysis and onboarding of thin-file customers.
2. Customer Onboarding and Verification
Financial institutions can prefill names, Udyam numbers, or UAN details using the APIs, making customer onboarding seamless and reducing form abandonment rates.
3. KYC Simplification
Using mobile numbers to fetch verified data like UAN or Udyam streamlines KYC processes, reducing the time and cost associated with traditional document-based KYC.
4. Fraud Prevention
Banks and fintechs can use these APIs to verify whether a mobile number matches its corresponding data points, helping prevent fraud in applications or transactions.
This guide should give users a solid foundation to begin working with the Mobile to X APIs and explore their full potential in finance and banking use cases.
Automatic Salutation Removal
Mobile to Name, Mobile VPA (Basic) and Mobile to VPA (Advanced) APIs now do a salutation removal check, including Indian honorifics, so that all downstream APIs such as PAN Validation and Credit Report fetch have better success rates.
Mobile to Udyam API
Endpoint: /v2/financial_services/mobile_to_udyam
Sample Request Body
{
"reference_id": "XXXXXXXX",
"consent": true,
"purpose": "To verify user VPA/ Name",
"mobile": "XXXXXX"
}
Request Mapping Table
Key | Type | Meaning | Example |
---|---|---|---|
reference_id | String | Unique identifier for the transaction | "XX-wqdw-47d7-abe0-XXwege" |
consent | Boolean | User's consent for VPA verification | "true/false" |
purpose | String | Purpose of verification | To verify user VPA/ Name |
mobile | Integer | User's mobile number(10 digits) | "9999999999" |
Sample Response Body
{
"decentroTxnId": "XXXXXXXXXXXXX",
"status": "SUCCESS",
"responseCode": "S00000",
"message": "Udyam records retrieved Successfully",
"data": {
"result": [
{
"udyamNumber": "XXXXXXXX",
"udyamName": "XXXXXXXX",
"panLinkedToUdyam": "XXXXXXXXX"
}
]
},
"responseKey": "success_udyam_found"
}
Response Mapping Table
Key | Meaning | Example |
---|---|---|
decentroTxnId | Decentro Transaction ID | "D871D26379284A5FD4E550A2D8FE" |
status | Overall status of the verification | "SUCCESS" |
responseCode | Response code indicating the result | "S00000" |
message | Brief description of the status | "VPA fetched successfully" |
data | Detailed information about the verification | For the Mobile to Udyam API, this object will contain all the fields shown in the Data table |
responseKey | Unique identifier for the response type | "success_vpa_found" |
Mobile to Udyam Data Object Fields
Parameter Name | Description |
---|---|
data | A JSON object containing detailed information about the enterprise and its registration details. |
- udyamNumber | The unique Udyam registration number is assigned to the enterprise. |
- udyamName | The name of the enterprise. |
- panLinkedToUdyam | The PAN of the individual who represents the enterprise. |
Mobile to EPFO API
Endpoint
POST https://in.staging.decentro.tech/v2/bytes/mobile_to_epfo
Headers
Header | Description |
---|---|
client_id | Your assigned client identifier. |
client_secret | Your client's secret key for authentication. |
module_secret | The module secret key for the Bytes module. |
Content-Type | It should be set to application/json . |
Request Body
The request body should be in JSON format. Below is a breakdown of each field:
Field | Type | Description | Required |
---|---|---|---|
reference_id | string | A unique identifier for tracking the request (UUID format). | Yes |
consent | boolean | A flag indicating user consent for fetching UAN details. | Yes |
purpose | string | A short description of the request's purpose, e.g., "To fetch the user's UAN details." | Yes |
mobile | string | The mobile number associated with the UAN details to be fetched. | Yes |
Sample Request
curl --location 'https://in.staging.decentro.tech/v2/bytes/mobile_to_epfo' \
--header 'client_id: XXXXXX' \
--header 'client_secret: XXXXXX' \
--header 'module_secret: XXXXXXXXX' \
--header 'Content-Type: application/json' \
--data '{
"reference_id": "XXXXXXXXX",
"consent": true,
"purpose": "To fetch the user's UAN details",
"mobile": "XXXXXXXXXXXX"
}'
Sample Response
{
"decentroTxnId": "XXXXXXXXX",
"status": "SUCCESS",
"responseCode": "S00000",
"message": "EPFO Search by Mobile Success.",
"data": {
"uan": [
"101658327979"
],
"uanDetails": {
"101658327979": {
"memberId": "GNGGN19609610000010022",
"establishmentId": "GNGGN1960961000",
"dateOfExit": "2022-07-31",
"dateOfJoining": "2022-05-02",
"leaveReason": "",
"establishmentName": "SAMPLE ESTABLISHMENT NAME"
}
}
},
"responseKey": "success_epfo_details_fetched"
}
Response Fields
Key | Description |
---|---|
decentroTxnId | Unique transaction identifier generated by Decentro for this API call. |
status | Indicates the status of the API request, such as SUCCESS if the operation was successful. |
responseCode | A code representing the result of the API call. For example, S00000 usually signifies success. |
message | A human-readable message providing additional details about the API response. |
data | Contains the main data returned by the API, including details about the UAN and associated info. |
uan | An array containing one or more UANs associated with the provided mobile number. |
uanDetails | A nested object containing detailed information about each UAN. |
memberId | Unique identifier for the member within the EPFO system. |
establishmentId | Identifier for the establishment (employer) associated with the member. |
dateOfExit | The date when the member exited the establishment, if applicable (format: YYYY-MM-DD). |
dateOfJoining | The date when the member joined the establishment (format: YYYY-MM-DD). |
leaveReason | Reason for leaving the establishment; may be empty if not recorded. |
establishmentName | The name of the establishment (employer) associated with the UAN. |
responseKey | A predefined key indicating the type of response, e.g., success_epfo_details_fetched . |
Updated 4 days ago