Fetch Verification

This lets you fetch the details of a verification by its ID.

Tazamatch is coming soon. The APIs listed here are for reference only and are not yet available in production or sandbox.

cURL

curl --request GET \
  --url https://service-sandbox.tazapay.com/v3/verification/payee/ver_xxxx \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "status": "success",
  "message": "",
  "data": {
    "id": "ver_xxxx",
    "object": "verification",
    "verification_status": "valid",
    "status_description": "",
    "beneficiary": "bnf_xxxx",
    "beneficiary_details": {
      "type": "individual",
      "address": {
        "city": "Mumbai",
        "country": "IN",
        "line1": "123 Main Street",
        "line2": null,
        "postal_code": "400001",
        "state": "Maharashtra"
      },
      "phone": {
        "calling_code": "+91",
        "number": "9876543210"
      },
      "tax_id": null,
      "destination": "bnk_xxxx"
    },
    "destination_details": {
      "type": "bank",
      "local_payment_network": null
    },
    "verified_information": {
      "name_match_details": {
        "type": "continuous",
        "value": 0.97,
        "summary": "strong_match",
        "matched_name_translation": null,
        "corrected_name_returned": null
      },
      "account_exists": true,
      "beneficiary_type": "individual",
      "bank": {
        "account_number": "9876543210",
        "account_type": "savings",
        "bank_codes": {
          "ifsc_code": "HDFC0001234"
        },
        "bank_name": "HDFC Bank",
        "branch_name": null,
        "address": null,
        "country": "IN",
        "currency": "INR",
        "payment_scheme_eligibility": null
      },
      "transaction_activity_details": {
        "transaction_activity": null,
        "transaction_activity_since": null
      }
    },
    "balance": {
      "holding_currency": "USD",
      "balance_impact": 10,
      "balance_transaction_id": "txn_xxxx"
    },
    "metadata": null,
    "reference_id": null,
    "created_at": "2026-04-07T10:00:00Z",
    "updated_at": "2026-04-07T10:00:05Z"
  }
}

Retrieve Verification

GET /v3/verification/payee/{id}

Authorizations

Authorization · string · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

id · string · required

Unique ID of the verification object. Prefix: ver_.

Response

id · string

Unique identifier for the verification object. Prefix: ver_.

object · string

Fixed value: verification.

verification_status · enum

Current status of the verification. Allowed: valid, invalid.

status_description · string

Human-readable description of the verification status.

beneficiary · string

ID of the saved beneficiary used (bnf_xxxx). null for inline verifications.

beneficiary_details · object

Echo of the beneficiary details submitted in the original request or retrieved from the saved beneficiary object.

Show beneficiary_details

type · string

Type of beneficiary entity (individual or business).

tax_id · string

Tax identification number of the beneficiary.

destination · string

ID of the destination object associated with this beneficiary. null if inline destination_details were passed.

destination_details · object

Destination details echoed from the original request.

Show destination_details

type · string

Type of payout destination (e.g. bank, local_payment_network).

local_payment_network · object

Present when destination_details.type = local_payment_network.

verified_information · object

Provider-returned verification result. Present when verification_status.status = valid.

Show verified_information

account_exists · boolean

Indicates whether the account was found and recognised at the bank.

beneficiary_type · string

Whether the account belongs to an individual or business.

transaction_activity_details · object

Transaction activity details returned by the provider (Kinexys only).

balance · object

Balance details for this verification.

Show balance

holding_currency · string

Currency from which the merchant was charged for this verification. Either USD or the merchant’s primary currency, depending on which was utilised.

balance_impact · integer

Amount consumed for this verification.

balance_transaction_id · string

Transaction ID of the balance debit entry.

metadata · object

Key-value map of merchant-defined metadata. Echoed from the original request if provided. Max 10 keys; string values ≤ 500 chars each.

reference_id · string

Your reference ID echoed from the original request.

created_at · timestamp

Timestamp when the verification object was created.

updated_at · timestamp

Timestamp of the last status update.