List Verifications

This lets you retrieve a paginated list of verifications.

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

200

{
  "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

Authorization · string · required

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

Query Parameters

beneficiary · string

Filter by beneficiary ID (bnf_xxxx). Returns all verifications linked to the specified beneficiary.

limit · integer

Number of objects to return. Default: 10. Range: 1–100.

starting_after · string

Cursor for forward pagination. Pass the id of the last object from the previous page.

ending_before · string

Cursor for backward pagination. Pass the id of the first object from the current page.

created · object

Filter by creation time. Supports gt, gte, lt, lte as Unix timestamps (e.g. created[gte]=1700000000).

Response

object · string

Fixed value: list.

has_more · boolean

Whether more objects exist beyond the current page.

data · array

List of verification objects in reverse chronological order.

Show data[]

id · string

Unique identifier for the verification object. Prefix: ver_.

object · string

Fixed value: verification.

verification_status · enum

Status of the verification. Allowed: valid, invalid, pending, not_supported.

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

bank · object

Show bank

bank_codes · object

Container for bank routing identifiers.

additional_information · object

Additional provider-specific information. Not consistently available across all corridors.

Show additional_information

transaction_activity_details · object

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

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.