# Mobile to UPI Multiple

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

##  upi\_multiple

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/kyc/banking/upi_multiple`

### Post parameters description is given below,

<table><thead><tr><th width="197">Post Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>mobile_number</td><td>String </td><td>Yes </td><td>Mobile Number</td></tr></tbody></table>

#### Sample Post Parameters

```json
{
    "mobile_number": "6300000000"
}
```

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "status": "completed",
    "reference_id": "1856dd95-120d-4d96-90ef-9bc255daff34",
    "result": {
        "name": "Mr R XXXXXXX",
        "upi": [
            "6300000000@paytm",
            "6300000000@axl",
            "6300000000@kotak",
            "6300000000@upi",
            "6300000000@ybl"
        ],
        "txnId": "18e7feea-50f7-49f1-961c-eba44ec9d4bb"
    },
    "requested_at": "2026-03-03T06:18:50.079Z",
    "completed_at": "2026-03-03T06:19:05.365Z"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="400: Validation Error Response " %}

```json
{
    "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"
    }
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}

#### Check Document Status

## &#x20;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

<mark style="color:blue;">`GET`</mark> `https://secctrl.tutelar.io/api/v1/kyc/banking/upi_multiple`

### Query parameters description is given below,

<table><thead><tr><th width="197">Query Parameter </th><th width="139">Type</th><th>Is  Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>reference_id </td><td>String </td><td>Yes </td><td>Document reference id</td></tr></tbody></table>

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "status": "completed",
    "reference_id": "1856dd95-120d-4d96-90ef-9bc255daff34",
    "result": {
        "name": "Mr R XXXXXXX",
        "upi": [
            "6300000000@paytm",
            "6300000000@axl",
            "6300000000@kotak",
            "6300000000@upi",
            "6300000000@ybl"
        ],
        "txnId": "18e7feea-50f7-49f1-961c-eba44ec9d4bb"
    },
    "requested_at": "2026-03-03T06:18:50.079Z",
    "completed_at": "2026-03-03T06:19:05.365Z"
}
```

{% endtab %}

{% tab title="200: InProgress Response" %}

```json
{
    "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"
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "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"
}
```

{% endtab %}
{% endtabs %}