---
title: "Check Bulk Bank Account Verification Status API Reference"
description: "Poll for per-account results of a Bulk Bank Account Verification batch using the bulk_reference_id returned at submit time."
canonical: "https://eps.eko.in/docs/bulk-bank-account-verification-status"
---


> **Canonical URL:** https://eps.eko.in/docs/bulk-bank-account-verification-status
> This is a machine-readable Markdown version of the page for AI agents and LLMs. The primary (HTML) version lives at the canonical URL above.

# Check Bulk Bank Account Verification Status API Reference

`GET https://staging.eko.in/ekoapi/v3/tools/kyc/bank-account/bulk/status`

Poll for per-account results of a Bulk Bank Account Verification batch using the bulk_reference_id returned at submit time.

**Behaviour**

- **Read-only**: Changes nothing; only returns data.

Companion to the Bulk Bank Account Verification API. Because the batch runs asynchronously, callers poll this endpoint with the bulk_reference_id from the submit response to retrieve per-account penny-drop results as they complete. The response returns an entries array, one object per submitted account, each carrying the account-holder name at bank, bank/branch/MICR details, UTR, name-match score/result, and account status.

> View product & pricing details: [Bank Account Verification](https://eps.eko.in/products/bank-verification-api.md)

## Query parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| initiator_id | string | yes | Registered mobile number of the API user (see Platform Credentials). e.g. 9962981729 |
| client_ref_id | string | no | Unique reference ID per API call, generated by your system (10–20 characters; 10 recommended). The SDKs generate one for every non-GET call when you don't. e.g. 2026010100123456789 |
| bulk_reference_id | string | yes | The bulk_reference_id returned by the Bulk Bank Account Verification API for the submitted batch. e.g. 90438 |

## Headers

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| developer_key | string | yes | Static API key issued to your account after KYC. |
| secret-key | string | yes | Dynamic per-request signature: base64(HMAC-SHA256(timestamp, base64(access_key))). |
| secret-key-timestamp | string | yes | Current time in milliseconds since UNIX epoch, used to compute secret-key. Must match server time. |
| content-type | string | yes | application/json e.g. application/json |

## Response

⭐ marks fields highlighted as verifiable.

| Field | Type | Description |
| --- | --- | --- |
| status | number | Primary success indicator (0 = success). |
| message | string | Human-readable response / error message. |
| response_status_id | number | UI display hint only (-1/0 success, 1 failure, 2 initiated, 3 refund initiated, 4 refunded). Never branch on it — use `status` (and `tx_status` for financial APIs), or `response_type_id` where documented. |
| response_type_id | number | A unique id for every possible response shape (success or error) — useful for client logic branching and analytics. |
| data | object | API-specific response payload. |
| data.entries ⭐ | array | Per-account verification results — one object for each account submitted in the batch. |
| data.entries.reference_id | string | The reference_id you sent for this entry in the Bulk Bank Account Verification request. |
| data.entries.name_at_bank ⭐ | string | Account holder name as per bank records. |
| data.entries.bank_name ⭐ | string | Name of the financial institution. |
| data.entries.utr | string | Unique transaction reference number for the penny-drop credit. |
| data.entries.city | string | City where the bank branch is located. |
| data.entries.branch | string | Bank branch name. |
| data.entries.micr | number | MICR (ECS identification) code of the branch. |
| data.entries.name_match_score ⭐ | string | Confidence score for the supplied-name vs name-at-bank match. |
| data.entries.name_match_result ⭐ | string | Name match result (e.g. MATCH / NO_MATCH). |
| data.entries.account_status ⭐ | string | Current status of the bank account verification. |
| data.entries.account_status_code | string | Machine-readable account status code (e.g. ACCOUNT_IS_VALID). |

## Example response

```json
{
  "status": 0,
  "response_status_id": 0,
  "message": "Success",
  "response_type_id": 1388,
  "data": {
    "entries": [
      {
        "reference_id": "1",
        "name_at_bank": "JOHN DOE",
        "bank_name": "YES BANK",
        "utr": "SBIN0123456789",
        "city": "MUMBAI",
        "branch": "SANTACRUZ, MUMBAI",
        "micr": 400065001,
        "name_match_score": "100",
        "name_match_result": "MATCH",
        "account_status": "VALID",
        "account_status_code": "ACCOUNT_IS_VALID"
      }
    ]
  }
}
```

## Error scenarios

| Status | response_type_id | Scenario |
| --- | --- | --- |
| 400 | `1` | Missing or invalid bulk_reference_id |
| 404 | — | Unknown or expired bulk_reference_id |