Mobile to UPI Advance

API will provide the UPI Id and name for the mobile number provided.

upi_advance

POST https://secctrl.tutelar.io/api/v1/kyc/banking/upi_advance

Post parameters description is given below,

Post Parameter

Type

Is Mandatory

Description

mobile_number

String

Yes

Mobile Number

Sample Post Parameters

{
    "mobile_number": "6300000000"
}

{
    "success": true,
    "code": 200,
    "status": "completed",
    "reference_id": "6b5d8264-aeb3-48ab-b802-640f475419ba",
    "result": {
        "name": "Mr R XXXXXXX",
        "upi": true,
        "vpa": "6000000000@paytm",
        "txnId": "7ab59659-f5d2-4e73-9ab9-59b4cd739b51"
    },
    "requested_at": "2026-03-03T06:22:17.245Z",
    "completed_at": "2026-03-03T06:22:18.968Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
    "status": "in_progress",
    "requested_at": "2026-03-03T05:28:49.245Z"
}

{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "Invalid mobile number",
        "field": "mobile_number",
        "code": "BAD_REQUEST"
    }
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "ecd78066-c7e9-4c9b-ba97-8eb18ed32947",
    "status": "failed",
    "error": {
        "message": "Validation Failed",
        "code": "ERROR"
    },
    "requested_at": "2026-03-03T05:21:05.793Z",
    "completed_at": "2026-03-03T05:21:07.640Z"
}

Check Document Status

Get document details

This Get details API using to fetch the latest updated response when the above API gave the status as in-progress by using the reference_id

GET https://secctrl.tutelar.io/api/v1/kyc/banking/upi_advance

Query parameters description is given below,

Query Parameter

Type

Is Mandatory

Description

reference_id

String

Yes

Document reference id

{
    "success": true,
    "code": 200,
    "status": "completed",
    "reference_id": "6b5d8264-aeb3-48ab-b802-640f475419ba",
    "result": {
        "name": "Mr R XXXXXXX",
        "upi": true,
        "vpa": "6000000000@paytm",
        "txnId": "7ab59659-f5d2-4e73-9ab9-59b4cd739b51"
    },
    "requested_at": "2026-03-03T06:22:17.245Z",
    "completed_at": "2026-03-03T06:22:18.968Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request is being processed. Please wait for completion.",
    "reference_id": "10cc9473-ce11-425e-ac89-1f51ce6e78de",
    "status": "in_progress",
    "requested_at": "2026-03-03T05:28:49.245Z"
}

{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "ecd78066-c7e9-4c9b-ba97-8eb18ed32947",
    "status": "failed",
    "error": {
        "message": "Validation Failed",
        "code": "ERROR"
    },
    "requested_at": "2026-03-03T05:21:05.793Z",
    "completed_at": "2026-03-03T05:21:07.640Z"
}

PreviousMobile to UPI Multiple NextBank Statement Analyse

Last updated 2 days ago

hashtag upi_advance

hashtagPost parameters description is given below,

hashtagSample Post Parameters

hashtagCheck Document Status

hashtag Get document details

hashtagQuery parameters description is given below,