Mobile to Multiple Bank Account

Endpoint Overview

POST /api/v1/bank-verification/mobile-to-multiple-account

Description

The Mobile to Multiple Bank Account API enables you to retrieve all bank accounts linked to a specific mobile number. This endpoint is designed to streamline the process of mapping a mobile number to multiple associated bank accounts, providing verified account holder details and banking information in a single, secure response.

This API is particularly valuable for businesses and platforms that require robust KYC (Know Your Customer) processes, fraud prevention, or seamless onboarding experiences. By leveraging this endpoint, organizations can quickly validate user-provided mobile numbers and fetch all associated bank accounts, ensuring compliance and reducing manual verification efforts.

Key Benefits

Instantly fetch all bank accounts linked to a mobile number.

Reduces manual KYC verification and onboarding time.

Enhances fraud detection and risk mitigation.

Provides verified account holder details for regulatory compliance.

Use Cases

Banking & Fintech

E-commerce & Marketplaces

Insurance & Lending

Streamlined customer onboarding by verifying all accounts linked to a mobile number.

Automated KYC checks for loan applications or new account openings.

Technical Implementation

Authentication

All API requests require authentication using a JWT Bearer token. Authentication follows these steps:

Obtain API Credentials: Register with Surepass to receive your API key.

Generate JWT Token: Use your API key to generate a JWT token.

Include in Requests: Add the token to the Authorization header as Bearer TOKEN.

Different authentication tokens are used for sandbox and production environments:

Sandbox: https://sandbox.surepass.app

Production: https://kyc-api.surepass.app

Request Parameters

Request Headers

Header	Required	Description
Authorization	Yes	Bearer token for authentication (`Bearer JWT`)
Content-Type	Yes	Must be `application/json`

Request Body

Parameter	Type	Required	Description
mobile_number	string	Yes	The mobile number to be verified.

Example Request

{
  "mobile_number": "9234567890"
}

Process Response

Response Parameters

Parameter	Type	Description
data	object	Contains the verification result and account details.
data.client_id	string	Unique identifier for the verification request.
data.mobile_number	string	The mobile number that was verified.
data.details	array	List of bank accounts linked to the mobile number.
data.details[].full_name	string	Account holder’s full name.
data.details[].account_number	string	Bank account number.
data.details[].ifsc	string	IFSC code of the bank branch.
status_code	number	HTTP status code of the response.
success	boolean	Indicates if the request was successful.
message	string	Human-readable message describing the result.
message_code	string	Machine-readable message code.

Example Successful Response

{
  "data": {
    "client_id": "mobile_to_multiple_account_xkshYhduqplMnoZtGrt",
    "mobile_number": "9234567890",
    "details": [
      {
        "full_name": "RAHUL SHARMA",
        "account_number": "123456789012",
        "ifsc": "HDFC0001234"
      },
      {
        "full_name": "PRIYA VERMA",
        "account_number": "987654321098",
        "ifsc": "SBIN0005678"
      },
      {
        "full_name": "AMAN GUPTA",
        "account_number": "456789123456",
        "ifsc": "ICIC0004321"
      }
    ]
  },
  "status_code": 200,
  "success": true,
  "message": "Success",
  "message_code": "success"
}

Possible Error Responses

Invalid Mobile Number

Authentication Error

{
  "status_code": 422,
  "success": false,
  "message": "Verification Failed.",
  "message_code": "verification_failed"
}

Invalid Mobile Number or no bank account is linked to the provided mobile number.

Integration Best Practices

Security Recommendations

Always use HTTPS to encrypt API requests and responses.

Store JWT tokens securely and rotate them regularly.

Never expose your API keys or tokens in client-side code.

Validate and sanitize all input parameters to prevent injection attacks.

User Experience Guidelines

Display clear error messages to users when verification fails.

Mask sensitive information (like account numbers) in UI displays.

Provide real-time feedback during verification to enhance trust.

Handle and retry transient errors gracefully.

Code Samples

cURL

Python

Node.js

Related APIs

Single Bank Account Verification API: Verify a single bank account using account number and IFSC.

Bank Account Name Match API: Validate if the provided account holder name matches the bank records.

Bank Account Status API: Check the operational status of a bank account.

Compliance and Legal Considerations

Ensure all API usage complies with local data privacy regulations (such as RBI, GDPR, etc.). Only use this API for legitimate business purposes with user consent. Do not store or share sensitive banking information unless required for compliance or business operations.

curl --location --request POST 'https://kyc-api.surepass.app/api/v1/bank-verification/mobile-to-multiple-account' \ --header 'Content-Type: application/json' \ --data-raw '{ "mobile_number":"9234567890" }'

{ "data": { "client_id": "mobile_to_multiple_account_xkshYhduqplMnoZtGrt", "mobile_number": "9234567890", "details": [ { "full_name": "RAHUL SHARMA", "account_number": "123456789012", "ifsc": "HDFC0001234" }, { "full_name": "PRIYA VERMA", "account_number": "987654321098", "ifsc": "SBIN0005678" }, { "full_name": "AMAN GUPTA", "account_number": "456789123456", "ifsc": "ICIC0004321" } ] }, "status_code": 200, "success": true, "message": "Success", "message_code": "success" }

Mobile To Multiple Account

Mobile to Multiple Bank Account#

Description#

Use Cases#

Technical Implementation#

Request Headers#

Request Body#

Example Request#

Response Parameters#

Example Successful Response#

Possible Error Responses#

Integration Best Practices#

Code Samples#

Request

Responses

Mobile to Multiple Bank Account

Description

Use Cases

Technical Implementation

Request Headers

Request Body

Example Request

Response Parameters

Example Successful Response

Possible Error Responses

Integration Best Practices

Code Samples