Quickstart

Get from zero to your first BIN lookup in four steps.

1. Sign Up

Go to the dashboard and sign in with Google. An organisation is created for you automatically. You’ll start on the Development plan with unlimited requests and mock responses.

2. Create an API Key

Go to API Keys and click Create Key. Give it an optional name (e.g. “Development”) and copy the key when it appears — it’s only shown once.

See API Keys for more on managing keys.

3. Make Your First Request

Note: Development accounts return mock responses. The data structure matches production, but values are sample data. Upgrade to a paid plan for real BIN data.

curl -X POST "https://api.binlookupapi.com/v1/bin" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"number": 42467101}'

A successful response looks like this:

{
  "data": {
    "bin": "42467101",
    "scheme": "visa",
    "funding": "debit",
    "brand": "VISA",
    "category": "CLASSIC",
    "country": {
      "code": "PL",
      "name": "POLAND"
    },
    "issuer": {
      "name": "ING BANK SLASKI SA",
      "website": null,
      "phone": null
    },
    "currency": "PLN",
    "prepaid": false,
    "commercial": false
  }
}

See API Reference for the full request and response documentation.

4. Upgrade for Production Data

When you’re ready for real BIN data, navigate to Billing and choose a paid plan. Changes take effect immediately.

See Subscriptions for plan details and pricing.

Language Guides

Complete integration guides with production-ready code, error handling, and real-world examples:

Next Steps

• API Reference - Complete documentation with all parameters and response fields
• Subscriptions - Plan details and quota information
• API Keys - Managing your API credentials