{"info":{"_postman_id":"fa6df992-d0f3-4065-9917-f41965ee7a58","name":"Bank Validation API","description":"

Complete API collection for bank account validation services.

Features

Validate bank account numbers and account holder names
Support for 130+ Indonesian banks (BCA, BRI, BNI, BSI, Mandiri, SeaBank, and many more)
Name masking for privacy protection
Real-time account verification
Get list of all available banks
Flexible bank code input (accepts both \"mandiri\" and \"bank_mandiri\" formats)

Authentication

All requests require an API key in the x-api-co-id header.

Base URL

https://use.api.co.id/validation\n

Supported Banks

We support 130+ Indonesian banks including:

BCA (Bank Central Asia) - bca or bank_bca
BRI (Bank Rakyat Indonesia) - bri or bank_bri
BNI (Bank Negara Indonesia) - bni or bank_bni
BSI (Bank Syariah Indonesia) - bsi or bank_bsm
Mandiri (Bank Mandiri) - mandiri or bank_mandiri
SeaBank (SeaBank Indonesia) - seabank or bank_kesejahteraan_ekonomi
And 120+ more banks

Use the Get Available Banks endpoint to see the complete list of supported banks.

Bank Code Format

You can input bank codes in two formats:

Short format: mandiri, bca, bri (system automatically adds bank_ prefix)
Full format: bank_mandiri, bank_bca, bank_bri (used as-is)

Both formats work the same way. The system will automatically map short codes to full codes.

Validation Process

User provides bank code, account number, and account name
System maps bank code (adds bank_ prefix if needed)
System calls primary external bank validation API with retry logic (up to 2 retries)
If primary API fails, automatically falls back to secondary API
If account is found, server returns account holder name
System performs fuzzy matching between user-provided name and server name
If match score >= 7.0, validation is successful
Server name is masked for privacy (first 3 characters + ****)

Response Fields

is_valid: Boolean indicating if account validation passed
score: Float value (0.0 to 10.0) representing name match confidence
name: Masked account name showing first 3 chars + **** (only if valid, null if invalid)
message: Status message describing the validation result
note: Additional note (empty string if valid, \"Name was not returned\" if validation failed)

Use Cases

Payment gateway account verification
E-wallet registration
Financial service onboarding
KYC (Know Your Customer) compliance
Account ownership verification
Fraud prevention

\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[],"owner":"50289783","collectionId":"fa6df992-d0f3-4065-9917-f41965ee7a58","publishedId":"2sBXVZpuxM","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2025-12-26T17:36:01.000Z"},"item":[{"name":"Bank Validation","item":[{"name":"Validate Bank Account","id":"e53f909d-baef-4344-b85b-e274ce9e55af","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/validation/bank?bank_code=bank_bri&account_number=110601003647539&account_name=John Doe","description":"

Validate a bank account number and account holder name.

Example Request

curl --location 'http://localhost:3003/validation/bank?bank_code=bank_bri&account_number=110601003647539&account_name=John%20Doe' \\\n--header 'x-api-co-id: aF2ibmWX683ZxKwMK2svpv3nZDRIduinf2Vsq7HJI1QAGOdJkn'\n

Query Parameters

bank_code (required): Bank code identifier
- Can be short format: mandiri, bca, bri, bni, bsi, seabank
- Or full format: bank_mandiri, bank_bca, bank_bri, bank_bni, bank_bsm, bank_kesejahteraan_ekonomi
- Use GET /validation/bank/available to see all 130+ supported banks
\n
account_number (required): Bank account number to validate
account_name (required): Account holder name to match against bank records

Response

Returns validation result with:

is_valid: Boolean indicating if validation passed
score: Name matching score (0.0 to 10.0, >= 7.0 is valid)
name: Masked account name showing first 3 chars + **** (only if valid, null if invalid)
message: Status message
note: Additional note (empty if valid, \"Name was not returned on invalid validation\" if failed)

Validation Logic

System maps bank code (adds bank_ prefix if short format is used)
System calls primary external bank API with retry mechanism (up to 2 retries)
If primary API fails, automatically falls back to secondary API
If account is found, performs fuzzy name matching
Score >= 7.0 indicates successful validation
Valid names are masked for privacy (e.g., \"Rif**** Eln****\")

\n","urlObject":{"path":["validation","bank"],"host":["https://use.api.co.id"],"query":[{"description":{"content":"

Bank code - can be short format (mandiri, bca, bri) or full format (bank_mandiri, bank_bca, bank_bri). Use GET /validation/bank/available to see all supported banks.

\n","type":"text/plain"},"key":"bank_code","value":"bank_bri"},{"description":{"content":"

Bank account number

\n","type":"text/plain"},"key":"account_number","value":"110601003647539"},{"description":{"content":"

Account holder name to validate

\n","type":"text/plain"},"key":"account_name","value":"John Doe"}],"variable":[]}},"response":[{"id":"9952d7f0-ff17-4f90-adfc-6ca31f97e39f","name":"Success","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":{"raw":"https://use.api.co.id/validation/bank?bank_code=bank_bri&account_number=110601003647539&account_name=John Doe","host":["https://use.api.co.id"],"path":["validation","bank"],"query":[{"key":"bank_code","value":"bank_bri"},{"key":"account_number","value":"110601003647539"},{"key":"account_name","value":"John Doe"}]}},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"is_valid\": true,\n \"score\": 8.5,\n \"name\": \"Rif**** Eln****\",\n \"message\": \"Validation successful\",\n \"note\": \"\"\n }\n}"}],"_postman_id":"e53f909d-baef-4344-b85b-e274ce9e55af"},{"name":"Get Available Banks","id":"15212457-bc49-4728-b382-fe5e4a763ea1","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","description":"

Your API key for authentication

\n","type":"text"}],"url":"https://use.api.co.id/validation/bank/available","description":"

Get the complete list of all available banks supported by the validation API.

Response

Returns a list of all supported banks with:

banks: Array of bank objects
- bank_name: Full name of the bank (e.g., \"MANDIRI\", \"BCA\", \"BRI\")
- bank_code: Bank code to use in validation requests (e.g., \"bank_mandiri\", \"bank_bca\", \"bank_bri\")
\n
total: Total number of supported banks (130+)

Example Response

{\n    \"is_success\": true,\n    \"message\": \"Success\",\n    \"data\": {\n        \"banks\": [\n            {\n                \"bank_name\": \"MANDIRI\",\n                \"bank_code\": \"bank_mandiri\"\n            },\n            {\n                \"bank_name\": \"BCA\",\n                \"bank_code\": \"bank_bca\"\n            },\n            {\n                \"bank_name\": \"BRI\",\n                \"bank_code\": \"bank_bri\"\n            }\n            // ... 130+ more banks\n        ],\n        \"total\": 130\n    }\n}\n

Usage

Use this endpoint to:

Discover all supported banks
Get the correct bank code for validation requests
Build dynamic bank selection dropdowns in your application

Bank Code Format

You can use either:

Short format: Remove bank_ prefix (e.g., use mandiri instead of bank_mandiri)
Full format: Use the exact bank_code from the response

Both formats work the same way in validation requests.

\n","urlObject":{"path":["validation","bank","available"],"host":["https://use.api.co.id"],"query":[],"variable":[]}},"response":[{"id":"658629e5-6d92-422a-a6b6-7229d3d47883","name":"Success - Available Banks List","originalRequest":{"method":"GET","header":[{"key":"x-api-co-id","value":"YOUR_API_KEY_HERE","type":"text"}],"url":"https://use.api.co.id/validation/bank/available"},"status":"OK","code":200,"_postman_previewlanguage":"json","header":[{"key":"Content-Type","value":"application/json"}],"cookie":[],"responseTime":null,"body":"{\n \"is_success\": true,\n \"message\": \"Success\",\n \"data\": {\n \"banks\": [\n {\n \"bank_name\": \"MANDIRI\",\n \"bank_code\": \"bank_mandiri\"\n },\n {\n \"bank_name\": \"BCA\",\n \"bank_code\": \"bank_bca\"\n },\n {\n \"bank_name\": \"BRI\",\n \"bank_code\": \"bank_bri\"\n },\n {\n \"bank_name\": \"BNI\",\n \"bank_code\": \"bank_bni\"\n },\n {\n \"bank_name\": \"BSI (BANK SYARIAH INDONESIA)\",\n \"bank_code\": \"bank_bsm\"\n },\n {\n \"bank_name\": \"SEABANK/BANK BKE\",\n \"bank_code\": \"bank_kesejahteraan_ekonomi\"\n }\n ],\n \"total\": 130\n }\n}"}],"_postman_id":"15212457-bc49-4728-b382-fe5e4a763ea1"}],"id":"066762b5-2f01-4db5-ab3e-4aafac9874d3","description":"

Bank account validation endpoints for verifying account numbers and account holder names. Supports 130+ Indonesian banks with automatic fallback mechanism and flexible bank code input.

\n","_postman_id":"066762b5-2f01-4db5-ab3e-4aafac9874d3"}],"variable":[{"key":"base_url","value":"https://use.api.co.id","type":"string","description":"Base URL for the API"},{"key":"api_key","value":"YOUR_API_KEY_HERE","type":"string","description":"Your API key for authentication. Get it from api.dashboard or your database."}]}