API Reference

The core functionality of our API is centered around a single high-performance lookup endpoint. By providing a Bank Identification Number (BIN) and an optional IP address, you can retrieve issuer details, card attributes, and business intelligence.

Get/api/v1/lookup

Retrieve issuer details, card attributes, and security intelligence for a specific BIN.

Query Parameters

bin

Required

string

The first 6 to 11 digits of the payment card. Spaces and dashes are automatically stripped.

ip

Optional

string (IPv4/v6)

The IP address of the cardholder to perform country match intelligence and geolocation.

Response Structure

Our response follows a predictable JSON structure, with conditional objects that only appear when data is available.

Core Object

Contains binary validity, scheme (VISA, MASTERCARD), type (CREDIT, DEBIT), and ISO currency codes.

Issuer Object

Details about the issuing bank, including name, country, and contact info if available.

Attributes Object

Card characteristics like is_prepaid and is_commercial.

IP Location Object

Conditional: Only appears when the ipparameter is provided and lookup is successful.

Response Example

{"bin":"424242"
"valid":true
"scheme":"VISA"
"type":"CREDIT"
"card_category":
"currency_code":"USD"
"issuer":{...}
"attributes":{...}
"ip_location":{...}
"meta":{...}
}

Request Example (cURL)

curl --request GET 
  --url 'https://bin-lookup-ip-intelligence-api.p.rapidapi.com/api/v1/lookup?bin=424242&ip=8.8.8.8' 
  --header 'X-RapidAPI-Host: bin-lookup-ip-intelligence-api.p.rapidapi.com' 
  --header 'X-RapidAPI-Key: YOUR_API_KEY'