---
title: "Verify bank account details"
method: POST
path: "/verify/bank_verification"
tags: ["Bank Verification"]
---

# Verify bank account details

`POST /verify/bank_verification`

Verify a bank account by account_number and ifsc_code. Returns verification metadata including bank/branch details (from IFSC), account validity, a name-match score/result (if provided), and flag fields used for billing and consent. Requires X-API-KEY and X-Client-ID headers.

## Request body

- BankVerificationRequest
  - `account_number` string, required — Bank account number to verify. Digits only. Typical length varies by bank (commonly 9-18 digits).
  - `ifsc_code` string, required — 11-character IFSC code of the branch. Format: 4 letters (bank code) + '0' + 6 alphanumeric characters, e.g. SBIN0123456.

## Response `200`

Successful verification. Returns result object with account and IFSC details.

- BankVerificationResponse
  - `status` string, required
  - `message` string, nullable
  - `error_code` string, nullable
  - `data` BankData
    - `account_status` string, nullable
    - `account_holder_name` string, nullable
    - `account_number` string, nullable
    - `account_ifsc` string, nullable
    - `failure_reason` string, nullable
    - `extras` object, nullable
  - `tranx_id` string, nullable
  - `timestamp` string, nullable

## Other responses

- `400` — Bad request — missing or invalid account_number/ifsc_code.
- `401` — Unauthorized — missing or invalid API credentials.
- `404` — Not found — account or IFSC details not found.
- `500` — Internal server error — unexpected server failure during verification.

---

[API](https://skmtc.dev/idto/apis/verification-api.md) · [All operations](https://skmtc.dev/idto/apis/verification-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/idto/verification-api/revisions/e3d57dab8db4/schema)