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

KeyTypeMeaningExample
reference_idStringUnique identifier for the transaction"XX-wqdw-47d7-abe0-XXwege"
consentBooleanUser's consent for VPA verification"true/false"
purposeStringPurpose of verificationTo verify user VPA/ Name
mobileIntegerUser'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

KeyMeaningExample
decentroTxnIdDecentro Transaction ID"D871D26379284A5FD4E550A2D8FE"
statusOverall status of the verification"SUCCESS"
responseCodeResponse code indicating the result"S00000"
messageBrief description of the status"VPA fetched successfully"
dataDetailed information about the verificationFor the Mobile to Udyam API, this object will contain all the fields shown in the Data table
responseKeyUnique identifier for the response type"success_vpa_found"

Mobile to Udyam Data Object Fields

Parameter NameDescription
dataA JSON object containing detailed information about the enterprise and its registration details.
- udyamNumberThe unique Udyam registration number is assigned to the enterprise.
- udyamNameThe name of the enterprise.
- panLinkedToUdyamThe 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

HeaderDescription
client_idYour assigned client identifier.
client_secretYour client's secret key for authentication.
module_secretThe module secret key for the Bytes module.
Content-TypeIt should be set to application/json.

Request Body

The request body should be in JSON format. Below is a breakdown of each field:

FieldTypeDescriptionRequired
reference_idstringA unique identifier for tracking the request (UUID format).Yes
consentbooleanA flag indicating user consent for fetching UAN details.Yes
purposestringA short description of the request's purpose, e.g., "To fetch the user's UAN details."Yes
mobilestringThe 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

KeyDescription
decentroTxnIdUnique transaction identifier generated by Decentro for this API call.
statusIndicates the status of the API request, such as SUCCESS if the operation was successful.
responseCodeA code representing the result of the API call. For example, S00000 usually signifies success.
messageA human-readable message providing additional details about the API response.
dataContains the main data returned by the API, including details about the UAN and associated info.
uanAn array containing one or more UANs associated with the provided mobile number.
uanDetailsA nested object containing detailed information about each UAN.
memberIdUnique identifier for the member within the EPFO system.
establishmentIdIdentifier for the establishment (employer) associated with the member.
dateOfExitThe date when the member exited the establishment, if applicable (format: YYYY-MM-DD).
dateOfJoiningThe date when the member joined the establishment (format: YYYY-MM-DD).
leaveReasonReason for leaving the establishment; may be empty if not recorded.
establishmentNameThe name of the establishment (employer) associated with the UAN.
responseKeyA predefined key indicating the type of response, e.g., success_epfo_details_fetched.