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

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 |
| bulk_reference_id | string | yes | Unique id returned by the Bulk Bank Account Verification API for the submitted batch. e.g. 3356655212 |

## 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 | Granular status id; see the shared error-codes table. |
| 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 | Unique reference id created for this account's verification. |
| 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 | string | 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 | number | Numeric code representing the account status. |

## Example response

```json
{
  "status": 0,
  "response_status_id": 0,
  "message": "Success",
  "response_type_id": 1388,
  "data": {
    "entries": [
      {
        "reference_id": "983654",
        "name_at_bank": "JOHN DOE",
        "bank_name": "STATE BANK OF INDIA",
        "utr": "SBIN0123456789",
        "city": "BANGALORE",
        "branch": "MG ROAD",
        "micr": "560002001",
        "name_match_score": "100",
        "name_match_result": "MATCH",
        "account_status": "VALID",
        "account_status_code": 0
      }
    ]
  }
}
```

## Error scenarios

| Status | Scenario |
| --- | --- |
| 400 | Missing bulk_reference_id |
| 404 | Unknown or expired bulk_reference_id |