Skip to main content
POST
Verify an account by penny drop

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Body

application/json

Request to verify a bank account.

name and mobile are optional details about who the account is expected to belong to. Both are passed to the source as supplied, and neither changes the verdict: the answer is about the account, and the name the bank holds comes back either way.

ifsc
string
required

IFSC of the account's branch

Pattern: ^[A-Za-z]{4}[a-zA-Z0-9]{7}$
account_number
string
required

Bank account number

Pattern: ^[A-Za-z0-9]{1,40}$
name
string | null

Name claimed to hold the account, if you have one

Maximum string length: 100
mobile
string | null

Account holder's mobile, if you have one

Pattern: ^[6-9]\d{9}$

Response

Successful Response

Response to a penny-drop verification.

code
integer
required

HTTP status code of the response

timestamp
integer
required

Unix millisecond timestamp of when the response was produced

transaction_id
string
required

Identifier for this call. Quote it when raising a query about one

data
PennyDrop · object
required

What the bank reported for a penny-drop verification.

message states the outcome in the bank's own words, including the cases where the account could not be reached at all, such as an offline beneficiary bank or an unavailable NPCI. Fields beyond it are populated only as far as the verification got.