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[]

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.

​List Verifications

​Authorizations

​Query Parameters

​Response

List Verifications

Authorizations

Query Parameters

Response