> ## Documentation Index
> Fetch the complete documentation index at: https://developer.tazapay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Fetch Verification

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

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

```bash cURL theme={null}
curl --request GET \
  --url https://service-sandbox.tazapay.com/v3/verification/payee/ver_xxxx \
  --header 'Authorization: Basic <encoded-value>'
```

```json 200 theme={null}
{
  "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

<ParamField header="Authorization" type="string" required>
  Basic authentication header of the form `Basic <encoded-value>`, where `<encoded-value>` is the base64-encoded string `username:password`.
</ParamField>

#### Path Parameters

<ParamField path="id" type="string" required>
  Unique ID of the verification object. Prefix: `ver_`.
</ParamField>

#### Response

<ResponseField name="id" type="string">
  Unique identifier for the verification object. Prefix: `ver_`.
</ResponseField>

<ResponseField name="object" type="string">
  Fixed value: `verification`.
</ResponseField>

<ResponseField name="verification_status" type="enum">
  Current status of the verification. Allowed: `valid`, `invalid`.
</ResponseField>

<ResponseField name="status_description" type="string">
  Human-readable description of the verification status.
</ResponseField>

<ResponseField name="beneficiary" type="string">
  ID of the saved beneficiary used (`bnf_xxxx`). `null` for inline verifications.
</ResponseField>

<ResponseField name="beneficiary_details" type="object">
  Echo of the beneficiary details submitted in the original request or retrieved from the saved beneficiary object.

  <Expandable title="beneficiary_details">
    <ResponseField name="type" type="string">
      Type of beneficiary entity (`individual` or `business`).
    </ResponseField>

    <ResponseField name="tax_id" type="string">
      Tax identification number of the beneficiary.
    </ResponseField>

    <ResponseField name="destination" type="string">
      ID of the destination object associated with this beneficiary. `null` if inline `destination_details` were passed.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="destination_details" type="object">
  Destination details echoed from the original request.

  <Expandable title="destination_details">
    <ResponseField name="type" type="string">
      Type of payout destination (e.g. `bank`, `local_payment_network`).
    </ResponseField>

    <ResponseField name="local_payment_network" type="object">
      Present when `destination_details.type = local_payment_network`.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="verified_information" type="object">
  Provider-returned verification result. Present when `verification_status.status = valid`.

  <Expandable title="verified_information">
    <ResponseField name="account_exists" type="boolean">
      Indicates whether the account was found and recognised at the bank.
    </ResponseField>

    <ResponseField name="beneficiary_type" type="string">
      Whether the account belongs to an `individual` or `business`.
    </ResponseField>

    <ResponseField name="transaction_activity_details" type="object">
      Transaction activity details returned by the provider (Kinexys only).
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="balance" type="object">
  Balance details for this verification.

  <Expandable title="balance">
    <ResponseField name="holding_currency" type="string">
      Currency from which the merchant was charged for this verification. Either `USD` or the merchant's primary currency, depending on which was utilised.
    </ResponseField>

    <ResponseField name="balance_impact" type="integer">
      Amount consumed for this verification.
    </ResponseField>

    <ResponseField name="balance_transaction_id" type="string">
      Transaction ID of the balance debit entry.
    </ResponseField>
  </Expandable>
</ResponseField>

<ResponseField name="metadata" type="object">
  Key-value map of merchant-defined metadata. Echoed from the original request if provided. Max 10 keys; string values ≤ 500 chars each.
</ResponseField>

<ResponseField name="reference_id" type="string">
  Your reference ID echoed from the original request.
</ResponseField>

<ResponseField name="created_at" type="timestamp">
  Timestamp when the verification object was created.
</ResponseField>

<ResponseField name="updated_at" type="timestamp">
  Timestamp of the last status update.
</ResponseField>