Bank Account

Banking & Credit

Verifies a bank account number and IFSC in real time and returns the account holder name with optional name-match score.

Endpoint

POST https://app.emver.io/api/sandbox/v1/bank-account

Authorization: Bearer YOUR_API_KEY

Content-Type: application/json

Accept: application/json

Request parameters

Field	Type	Description
`bank_account_number` required	string	Account Number
`bank_ifsc` required	string	IFSC Code 11-character IFSC
`bank_holder_name` optional	string	Account Holder Name Optional - used for name match

Example request

cURL

curl -X POST https://app.emver.io/api/sandbox/v1/bank-account \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{
    "bank_account_number": "string",
    "bank_ifsc": "string",
    "bank_holder_name": "string"
}'

import requests

response = requests.post(
    "https://app.emver.io/api/sandbox/v1/bank-account",
    headers={
        "Authorization": "Bearer YOUR_API_KEY",
        "Accept": "application/json",
    },
    json={
        "bank_account_number": "string",
        "bank_ifsc": "string",
        "bank_holder_name": "string"
    },
    timeout=60,
)
response.raise_for_status()
data = response.json()

const response = await fetch("https://app.emver.io/api/sandbox/v1/bank-account", {
  method: "POST",
  headers: {
    "Authorization": "Bearer YOUR_API_KEY",
    "Content-Type": "application/json",
    "Accept": "application/json",
  },
  body: JSON.stringify({
      "bank_account_number": "string",
      "bank_ifsc": "string",
      "bank_holder_name": "string"
  }),
});

const data = await response.json();

$response = Http::withToken('YOUR_API_KEY')
    ->acceptJson()
    ->post('https://app.emver.io/api/sandbox/v1/bank-account', {
        "bank_account_number": "string",
        "bank_ifsc": "string",
        "bank_holder_name": "string"
    });

$data = $response->json();

Replace YOUR_API_KEY and the placeholder values. Use the switch above to see production URLs.

Response

Structure · 200

{
  "status": INTEGER,
  "message": STRING
}

Example · 200

{
  "status": 200,
  "message": "string"
}

Error · 4xx / 5xx

{
  "status": INTEGER,
  "message": STRING
}

See Errors & status codes for what each status means and which calls are billed.

About this API

Bank Account

Verifies a bank account number and IFSC in real time and returns the account holder name with optional name-match score.

Endpoint

POST /api/v1/bank-account
Content-Type: application/json

Request parameters

Field	Required	Description
`bank_account_number`	Yes	Account Number. Example: `50100012345678`
`bank_ifsc`	Yes	IFSC Code - 11-character IFSC. Example: `HDFC0000123`
`bank_holder_name`	No	Account Holder Name - Optional - used for name match. Example: `Rahul Sharma`

Sample request

{
  "bank_account_number": "50100012345678",
  "bank_ifsc": "HDFC0000123",
  "bank_holder_name": "Rahul Sharma"
}

Sample success response

{
  "status": 200,
  "message": "Verification successful",
  "data": {
    "account_status": "...",
    "account_holder_name": "...",
    "name_match": "...",
    "name_match_score": "...",
    "bank_reference_number": "...",
    "bank_name": "...",
    "branch": "...",
    "bank_address": "..."
  }
}

Sample error response

{
  "status": 404,
  "message": "No record found for the given input"
}

Response status codes

The status field in the response body indicates the verification outcome.

status	Meaning
`200`	Verification successful
`400`	Invalid input / verification failed
`422`	Invalid or missing input parameters
`500`	Source unavailable - retry later