Skip to main content
POST
/
verification
/
bank-verification-advance
Verify Bank Account (Advance)
curl --request POST \
  --url https://bgv.konnectnxt.com/api/verification/bank-verification-advance \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '
{
  "account_number": "380234932948989",
  "ifsc": "SBIN0001234",
  "name": "John Doe",
  "is_penny_drop": false
}
'
{
  "status": "success",
  "code": 200,
  "message": "Data Fetched Successfully.",
  "data": {
    "case_id": "12345",
    "beneficiary_name": "JOHN DOE",
    "verification_status": "VERIFIED",
    "name_match_score": "100.00",
    "ifscDetails": {
      "ifsc": "ABCD0123456",
      "name": "Example Bank",
      "branch": "MAIN BRANCH",
      "center": "MAIN CENTER",
      "district": "CENTRAL DISTRICT",
      "state": "STATE NAME",
      "address": "123 Example Street, Area, City, 123456",
      "contact": "+911234567890",
      "imps": true,
      "rtgs": true,
      "city": "EXAMPLE CITY",
      "iso3166": "IN-XX",
      "neft": true,
      "micr": "123456789",
      "upi": true,
      "swift": ""
    }
  },
  "credits_used": 1,
  "credits_remaining": 9999
}
This API verifies the details of a bank account associated with an individual. It requires the following input parameters:
  • Account Number: The bank account number to be verified.
  • IFSC: The Indian Financial System Code of the bank branch.

​
Optional Feature

  • Name Match Verification: Optionally, the API can perform a name match verification.
  • Penny Drop: Optionally, the API can perform a penny drop to the account to be verified.

​
400 Response Messages

​
Account Number Errors

  • account_number is required.
  • account_number must be a string.
  • account_number must be at least 9 character long.
  • Account number must contain only numeric characters.

​
IFSC Errors

  • ifsc is required.
  • ifsc must be a string.
  • ifsc must be exactly 11 characters long.
  • Invalid IFSC format. Example: ‘SBIN0001234’.

​
Name Errors

  • name must be a string.
  • name is invalid.
  • Name must not contain special characters or numbers.

​
Payload Errors

  • Payload is missing.

Authorizations

​
Authorization
string
header
required

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

Body

application/json
​
account_number
string
required
  • Account Number must be in the format XXXXXXXXXXXXXXX
  • It should not contain all identical digits in the numeric part.
  • Min Length: 9
Minimum string length: 9
Example:

"380234932948989"

​
ifsc
string
required
  • IFSC code must be exactly 11 characters long.
  • It should follow the format: 4 letters, followed by 0, followed by 6 alphanumeric characters.
Required string length: 11
Example:

"SBIN0001234"

​
name
string

Optional. Must not contain special characters or numbers.

Pattern: ^[a-zA-Z\s]*$
Example:

"John Doe"

​
is_penny_drop
boolean
default:false

Optional. If true, then penny will be dropped to the account to be verified.

Example:

false

Response

Successful response with bank account details.

​
status
enum<string>
required

Overall status of the API

Available options:
success,
error
​
code
integer
required

HTTP status code

Example:

400

​
message
string
required

Description of the response or error

Example:

"Invalid request parameters"

​
data
object
required
​
credits_used
integer
required

Represents the total number of credits used in this request.

Example:

3

​
credits_left
integer
required

Represents the remaining credits available for use.

Example:

4040