BIN Lookup
The fastest way to identify any payment card from its first 6-8 digits. Given a BIN (Bank Identification Number) or IIN, returns: - Issuing bank name, URL, phone, and city - Card brand (Visa, Mastercard, Amex, Discover, and more) - Card type (Credit / Debit) and level (Classic, Gold, Platinum, etc.) - Prepaid and commercial card flags - Country of issuance with ISO code, currency, coordinates,…
BIN Lookup endpoints
| Method | Endpoint | Description |
|---|---|---|
| bin | ||
| POST |
bin_batch_lookup /bin/batch |
Look up up to 100 BINs in a single request. Invalid or unknown BINs return valid=false. |
| POST |
bin_lookup_post /bin |
Look up a single BIN via JSON body. Preferred for privacy — BIN never appears in URL logs. Include `ip` in the body to check country match. |
| GET |
bin_lookup_get /bin/{bin_input} |
Look up a single BIN by path parameter. Optionally pass `?ip=` to check if the customer's IP country matches the BIN issuing country. |
| health | ||
| GET |
health_health_get /health |
Health check com estado do store em memória. Exemplo: GET /health → {"status": "ok", "store": {"loaded": true, "bin_count": 482341, ...}} |
| ip | ||
| GET |
ip_lookup /ip/{ip} |
Geolocate an IPv4 or IPv6 address. Returns country code, name, and coordinates. |
BIN Lookup pricing
| Plan | Price | Rate limit | Quotas |
|---|---|---|---|
| BASIC | Free | 10 / second |
|
| PRO | $9 / month | 30 / second |
|
| ULTRA | $29 / month | 60 / second |
|
| MEGA Recommended | $79 / month | 120 / second |
|