UPI / VPA Verification v2

Checks whether a UPI ID (Virtual Payment Address, e.g. 9999999999@ybl) exists and returns the name registered against it, as canonical fields (vpa_holder_name, vpa, is_valid, name_match, name_match_score, extras).

Response contract: A successful verification returns HTTP 200 with status: "success", error_code: null, and a populated data object. A definitive no-record / invalid result (the UPI ID does not exist) ALSO returns HTTP 200 with status: "success", but carries a non-null error_code and data: null — every 2xx response is status: "success", so do NOT distinguish a full-success verdict from a no-record one by status; branch on error_code (null = found, a non-null IDTO_2xx = not found). Only a raised error returns status: "error". Every response carries billed (whether the call was charged). All codes, messages and HTTP statuses are identical regardless of the underlying vendor. Authenticate with your X-Client-ID and X-API-KEY headers.

Codes: IDTO_202 (2xx, UPI ID invalid or does not exist — a definitive, chargeable verdict; the SAME universal no-record code used by every v2 product), IDTO_001 (missing or malformed UPI ID, 400), IDTO_009 (insufficient credits, 402), IDTO_006 (rate limited, 429), IDTO_007 (config error, 500), IDTO_008 (service busy, 503).

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
length between 5 and 80
^[A-Za-z0-9._-]+@[A-Za-z]{2,}$

UPI ID / Virtual Payment Address to verify, of the form handle@bank. 5–80 characters. vpa is accepted as an alias for this field.

string | null

Optional expected account holder name. When provided, the response includes name_match and name_match_score.

Headers
string | null
Responses

401

Missing or invalid authentication credentials (X-Client-ID / X-API-KEY).

Language
Credentials
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json