Binlist API

⭐ Beginner's Pick Finance / No Auth Required Beginner HTTPS
Free to Use Varies (check documentation)

Overview

Binlist gives you free access to a database of Bank Identification Numbers (BINs), the first 6-8 digits of any credit or debit card number that identify the issuing bank and card type. You can look up card details like the bank name, country, card scheme (Visa, Mastercard), and card type without any authentication. This is perfect for beginners who want to detect card types in payment forms.

💡

Beginner Tip

Only send the first 6-8 digits of the card number — never send the full card number to third-party APIs for security reasons. Use the returned "scheme" field to show the correct card logo in your UI.

Available Data

Binlist data via REST API
JSON-formatted response data
Freely accessible without authentication

Example Response

JSON Response
{
  "status": "success",
  "data": {
    "result": "Data from Binlist",
    "description": "Public access to a database of IIN/BIN information",
    "timestamp": "2025-01-15T10:00:00Z"
  }
}

Field Reference

scheme The card network scheme, such as "visa", "mastercard", or "amex".
type Whether the card is a "debit" or "credit" card.
brand The card product brand, such as "Visa/Dankort" or "Mastercard Gold".
country.name The full country name where the issuing bank is located.
bank.name The name of the bank that issued the card.
prepaid Whether the card is a prepaid card.

Implementation Example

const url = "https://binlist.net/";
const response = await fetch(url);
if (!response.ok) throw new Error(`Request failed: ${response.status}`);
const data = await response.json();
console.log(data);

What Can You Build?

Note: These code examples are AI-generated and unverified. Always refer to the official API documentation for accurate usage.

Common Errors & Troubleshooting

404 Not Found The BIN is not in the Binlist database.
Not all BINs are in the database; handle the 404 gracefully in your code and treat it as unknown card details.
429 Too Many Requests You have exceeded the free rate limit of 10 requests per hour per IP.
Cache BIN lookups on your server so you only call the API once per unique BIN, or consider a paid service for higher volume.
Empty response fields Some BINs have incomplete data so certain fields may be null or missing.
Always check if a field exists before using it, e.g., check if response.bank exists before accessing response.bank.name.

Matrix Score Breakdown

🌐 Reachability 30/30
⚡ Speed 20/20
🔒 Security 15/15
🛠 Developer XP 20/20
✓ Reliability 7/15
Response Time 59ms

Fully tested on Apr 5, 2026

Technical Specifications

Auth No Auth
HTTPS REQUIRED
CORS UNKNOWN
Category Finance
Difficulty Beginner
Verified: 2026-04-04

Similar APIs

View All →