UPI
Banking & CreditVerifies a UPI ID / VPA and returns the linked account holder name, with optional name match against the supplied name.
Endpoint
POST
https://app.emver.io/api/sandbox/v1/upi
Authorization: Bearer YOUR_API_KEY
Content-Type: application/json
Accept: application/json
Request parameters
| Field | Type | Description |
|---|---|---|
upi_vpa
required
|
string | UPI ID / VPA |
upi_name
optional
|
string | Name Optional - used for name match |
Example request
cURL
curl -X POST https://app.emver.io/api/sandbox/v1/upi \
-H "Authorization: Bearer YOUR_API_KEY" \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{
"upi_vpa": "string",
"upi_name": "string"
}'
import requests
response = requests.post(
"https://app.emver.io/api/sandbox/v1/upi",
headers={
"Authorization": "Bearer YOUR_API_KEY",
"Accept": "application/json",
},
json={
"upi_vpa": "string",
"upi_name": "string"
},
timeout=60,
)
response.raise_for_status()
data = response.json()
const response = await fetch("https://app.emver.io/api/sandbox/v1/upi", {
method: "POST",
headers: {
"Authorization": "Bearer YOUR_API_KEY",
"Content-Type": "application/json",
"Accept": "application/json",
},
body: JSON.stringify({
"upi_vpa": "string",
"upi_name": "string"
}),
});
const data = await response.json();
$response = Http::withToken('YOUR_API_KEY')
->acceptJson()
->post('https://app.emver.io/api/sandbox/v1/upi', {
"upi_vpa": "string",
"upi_name": "string"
});
$data = $response->json();
Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.
Response
Structure · 200
{
"status": INTEGER,
"message": STRING
}
Example · 200
{
"status": 200,
"message": "string"
}
Error · 4xx / 5xx
{
"status": INTEGER,
"message": STRING
}
See Errors & status codes for what each status means and which calls are billed.
About this API
UPI
Verifies a UPI ID / VPA and returns the linked account holder name, with optional name match against the supplied name.
Endpoint
POST /api/v1/upi
Content-Type: application/jsonRequest parameters
| Field | Required | Description |
|---|---|---|
upi_vpa | Yes | UPI ID / VPA. Example: name@bank |
upi_name | No | Name - Optional - used for name match. Example: Rahul Sharma |
Sample request
{
"upi_vpa": "name@bank",
"upi_name": "Rahul Sharma"
}Sample success response
{
"status": 200,
"message": "Verification successful",
"data": {
"vpa": "...",
"account_holder_name": "...",
"name_match": "...",
"name_match_score": "..."
}
}Sample error response
{
"status": 404,
"message": "No record found for the given input"
}Response status codes
The status field in the response body indicates the verification outcome.
| status | Meaning |
|---|---|
200 | Verification successful |
400 | Invalid input / verification failed |
404 | No record found |
422 | Invalid or missing input parameters |
500 | Source unavailable - retry later |