# Validate Bank

Look up an Indian bank branch by its IFSC code. Returns the bank and branch details and whether the branch accepts NEFT, IMPS and RTGS. This is a directory lookup: it does not check a beneficiary account or send any funds (use `POST /v2/validate_account` to check an account). India only; any other `country` returns 400. Lookups are rate-limited per account.

Endpoint: POST /v2/validate_bank
Version: 3.0.0
Security: bearerAuth

## Security:

  - `bearerAuth` (unknown)
    http bearer JWT

## Request fields (application/json):

  - `country` (string, required)
    Enum: "BGD", "IND", "PAK", "PHL", "NPL", "EGY", "VNM", "NGA"

  - `bank_branch_code` (string, required)
    IFSC code of the branch, e.g. `HDFC0002019`.

## Response 200:

  - `200` (unknown)
    Successful Response

## Response 200 fields (application/json):

  - `valid` (boolean, required)
    Whether the IFSC code exists.

  - `bank` (string, required)
    Bank name.

  - `code` (string, required)
    Bank code.

  - `ifsc` (string, required)
    The IFSC code.

  - `micr` (string, required)
    MICR code of the branch.

  - `branch` (string, required)
    Branch name.

  - `city` (string, required)
    Branch city.

  - `district` (string, required)
    Branch district.

  - `state` (string, required)
    Branch state.

  - `address` (string, required)
    Branch address.

  - `neft` (boolean, required)
    Whether the branch accepts NEFT.

  - `imps` (boolean, required)
    Whether the branch accepts IMPS.

  - `rtgs` (boolean, required)
    Whether the branch accepts RTGS.

## Response 400:

  - `400` (unknown)
    Bad data in the request

## Response 400 fields (application/json):

  - `detail` (any)

## Response 401:

  - `401` (unknown)
    Access token not valid or expired

## Response 401 fields (application/json):

  - `detail` (any)

## Response 403:

  - `403` (unknown)
    Access token missing permissions to access the resource

## Response 403 fields (application/json):

  - `detail` (any)

## Response 422:

  - `422` (unknown)
    Unprocessable Entry

## Response 422 fields (application/json):

  - `detail` (any)

## Response 429:

  - `429` (unknown)
    Request rate is too high; back off and retry. Where a `retry-after` response header is present it gives the number of seconds to wait.

## Response 429 fields (application/json):

  - `detail` (any)

## Response 500:

  - `500` (unknown)
    Internal server error (contact administrator)

## Response 500 fields (application/json):

  - `detail` (any)