> ## 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.

# List Verifications

> This lets you retrieve a paginated list of verifications.

<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/verifications/payee?beneficiary=bnf_xxxx&limit=10' \
  --header 'Authorization: Basic <encoded-value>'
```

```json 200 theme={null}
{
  "status": "success",
  "message": "",
  "data": {
    "object": "list",
    "has_more": false,
    "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": {
          "match_details": {
            "type": "continuous",
            "value": 0.97,
            "summary": "strong_match"
          },
          "account_exists": true,
          "matched_name_details": {
            "matched_name_translation": null,
            "corrected_name_returned": null
          },
          "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
          },
          "additional_information": null
        },
        "metadata": null,
        "reference_id": null,
        "created_at": "2026-04-07T10:00:00Z",
        "updated_at": "2026-04-07T10:00:05Z"
      }
    ]
  }
}
```

# List Verifications

GET `/v3/verifications/payee`

Returns verification objects in reverse chronological order. Use the `beneficiary` filter to retrieve all verifications linked to a specific beneficiary, or use `created` filters to narrow by date range.

#### 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>

#### Query Parameters

<ParamField query="beneficiary" type="string">
  Filter by beneficiary ID (`bnf_xxxx`). Returns all verifications linked to the specified beneficiary.
</ParamField>

<ParamField query="limit" type="integer">
  Number of objects to return. Default: `10`. Range: `1–100`.
</ParamField>

<ParamField query="starting_after" type="string">
  Cursor for forward pagination. Pass the `id` of the last object from the previous page.
</ParamField>

<ParamField query="ending_before" type="string">
  Cursor for backward pagination. Pass the `id` of the first object from the current page.
</ParamField>

<ParamField query="created" type="object">
  Filter by creation time. Supports `gt`, `gte`, `lt`, `lte` as Unix timestamps (e.g. `created[gte]=1700000000`).
</ParamField>

#### Response

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

<ResponseField name="has_more" type="boolean">
  Whether more objects exist beyond the current page.
</ResponseField>

<ResponseField name="data" type="array">
  List of verification objects in reverse chronological order.

  <Expandable title="data[]">
    <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">
      Status of the verification. Allowed: `valid`, `invalid`, `pending`, `not_supported`.
    </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 = 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="bank" type="object">
          <Expandable title="bank">
            <ResponseField name="bank_codes" type="object">
              Container for bank routing identifiers.
            </ResponseField>
          </Expandable>
        </ResponseField>

        <ResponseField name="additional_information" type="object">
          Additional provider-specific information. Not consistently available across all corridors.

          <Expandable title="additional_information">
            <ResponseField name="transaction_activity_details" type="object">
              Transaction activity details returned by the provider (Kinexys only).
            </ResponseField>
          </Expandable>
        </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>
  </Expandable>
</ResponseField>