Developer Resources
BIN Checker API Documentation
Integrate our powerful BIN lookup capabilities directly into your applications with our simple and reliable REST API.
Reliable
99.9% uptime with fast response times and global CDN distribution
Comprehensive
Access to our extensive database of BINs from issuers worldwide
Secure
HTTPS encryption and optional API key authentication for all requests
Getting Started
Quick guide to using the BIN Checker API
Base URL: https://binsapi.vercel.app
Authentication
The public API endpoint doesn't require authentication for basic usage. For higher rate limits and additional features, contact us about our premium API plans.
Rate Limits
Public API: 100 requests per hour per IP address
Premium API: Custom limits based on your plan
Response Format
All API responses are returned in JSON format.
API Reference
Detailed documentation for all available endpoints
GET /api/bin
GET
Retrieve information about a single BIN.
Request Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
| bin | string | Yes | The first 6-8 digits of a card number |
Example Request
curl https://binsapi.vercel.app/api/bin?bin=411111Example Response
{
"number": "411111",
"country": "United States",
"flag": "🇺🇸",
"vendor": "Visa",
"type": "Credit",
"level": "Classic",
"bank_name": "JPMorgan Chase Bank, N.A."
}Response Fields
| Field | Type | Description |
|---|---|---|
| number | string | The BIN/IIN number |
| country | string | The country where the card was issued |
| flag | string | The country flag emoji |
| vendor | string | The card network (Visa, Mastercard, etc.) |
| type | string | The card type (Credit, Debit, Prepaid) |
| level | string | The card level (Classic, Gold, Platinum, etc.) |
| bank_name | string | The issuing bank or financial institution |
Error Responses
| Status Code | Error Message | Description |
|---|---|---|
| 400 | BIN parameter is required | The bin parameter was not provided |
| 404 | BIN not found | The requested BIN was not found in the database |
| 429 | Rate limit exceeded | You've exceeded the rate limit for API requests |
| 500 | Failed to process BIN request | An internal server error occurred |
Code Examples
Implementation examples in various programming languages
// Using fetch API
async function checkBin(bin) {
try {
const response = await fetch(`https://binsapi.vercel.app/api/bin?bin=${bin}`);
if (!response.ok) {
throw new Error(`Error: ${response.status}`);
}
const data = await response.json();
console.log(data);
return data;
} catch (error) {
console.error('Failed to check BIN:', error);
}
}
// Example usage
checkBin('411111');Need More Power?
Upgrade to our premium API for higher rate limits and additional features
Premium API Features
- Higher rate limits (up to 10,000 requests per hour)
- Additional data fields (issuer phone, website, etc.)
- Dedicated support and SLA guarantees
- Webhook notifications for database updates