Performs a detailed PAN lookup and returns canonical holder details (full_name, masked_aadhaar, address, email, phone, gender, dob, aadhaar_linked, category, bank_details).

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 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 / invalid one by status; branch on error_code (null = full success, a non-null IDTO_2xx = no record / invalid). 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. Field availability: email and phone_number are always returned masked in a canonical form (identical whichever vendor served the request); gender and bank_details are data-availability optional and are populated only when available for that PAN. Authenticate with your X-Client-ID and X-API-KEY headers.

Codes: IDTO_202 (2xx, no such PAN record), IDTO_001 (invalid PAN format / missing field, 400), IDTO_004 (duplicate verification reference, 409), IDTO_005 (user consent required, 400), IDTO_009 (insufficient credits, 402), IDTO_006 (rate limited, 429), IDTO_007 (config error, 500), IDTO_008 (service busy, 503).