REST API Documentation
Free BIN Lookup API - No authentication required
Base URL
https://binscan.live/api
Rate Limits
60 requests per minute per IP address. Exceeding this limit will result in a 429 (Too Many Requests) response.
Endpoints
GET
/api/bin/{bin}
Lookup BIN information by card number (first 6-8 digits)
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
bin |
string | Required | BIN number (6-8 digits) |
Example Request
GET https://binscan.live/api/bin/540131
Success Response (200)
{
"success": true,
"data": {
"bin": "540131",
"brand": "MASTERCARD",
"type": "CREDIT",
"level": "STANDARD",
"bank": "BANCO DE VENEZUELA",
"country": "VE",
"country_name": "VENEZUELA",
"country_flag": "🇻🇪",
"website": "",
"phone": ""
},
"by": "ordo.nagoya"
}
Error Response (404)
{
"success": false,
"error": "BIN not found",
"by": "ordo.nagoya"
}
Error Response (400)
{
"success": false,
"error": "BIN must be 6-8 digits",
"by": "ordo.nagoya"
}
GET
/api/stats
Get BIN database statistics
Example Request
GET https://binscan.live/api/stats
Success Response (200)
{
"total_bins": 374788,
"total_countries": 200,
"total_banks": 15000
}
Response Fields
| Field | Type | Description |
|---|---|---|
success | boolean | Whether the request was successful |
data.bin | string | The BIN number queried |
data.brand | string | Card brand (VISA, MASTERCARD, AMEX, etc) |
data.type | string | Card type (CREDIT, DEBIT, PREPAID) |
data.level | string | Card level (CLASSIC, GOLD, PLATINUM, etc) |
data.bank | string | Issuing bank name |
data.country | string | ISO 3166-1 alpha-2 country code |
data.country_name | string | Full country name |
data.country_flag | string | Country flag emoji |
by | string | API provider attribution |
Code Examples
cURL
curl -X GET "https://binscan.live/api/bin/540131" \ -H "Accept: application/json"
JavaScript (Fetch)
fetch('https://binscan.live/api/bin/540131')
.then(response => response.json())
.then(data => console.log(data))
.catch(error => console.error('Error:', error));
Python
import requests
response = requests.get('https://binscan.live/api/bin/540131')
data = response.json()
print(data)
PHP
$response = file_get_contents('https://binscan.live/api/bin/540131');
$data = json_decode($response, true);
print_r($data);
Try It Now
GET /api/bin/