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

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

Request
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.

Metadata Score Breakdown

Estimated from metadata — endpoint not independently tested

This score is estimated from observable metadata — HTTPS support, authentication model, declared CORS, and documentation reachability — because the API requires authentication or exposes no publicly testable endpoint. The five-signal breakdown is only shown for live-tested APIs.

Metadata estimate · endpoint not independently tested

Technical Specifications

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

Related Tags

Similar APIs

View All →