Quickstart

Get your first BIN lookup in four easy steps.

1. Sign Up

Go to the dashboard and sign in with Google; an organisation will be created for you automatically. You’ll start on the free tier with 10 real lookups per day — no credit card required.

2. Create an API Key

Go to API Keys and click Create Key. Keys are named automatically (rename them inline anytime); copy the key when it appears — it’s only shown once.

After creating a key, the dashboard shows a ready-to-run cURL command with your key pre-filled — copy it and you’ve made your first lookup.

See API Keys for more on managing keys.

3. Make Your First Request

Note: The free tier returns real production data, limited to 10 requests per day. Upgrade to a paid plan for higher limits.

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:

{
  "mode": "live",
  "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 Higher Limits

Once you need more than 10 lookups per day, navigate to Billing and choose a paid plan. Changes will be implemented 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