Quickstart

Install SmartBinDB from PyPI:

pip install smartbindb

Look up a single BIN

import asyncio
from smartbindb import SmartBinDB

db = SmartBinDB()

async def main():
    result = await db.aget_bin_info("457173")
    print(result)

asyncio.run(main())

Search BINs by issuing bank

import asyncio
from smartbindb import SmartBinDB

db = SmartBinDB()

async def main():
    result = await db.aget_bins_by_bank("Chase", limit=10)
    for entry in result["data"]:
        print(entry["bin"], entry["issuer"], entry["country_code"])

asyncio.run(main())

List BINs by country

import asyncio
from smartbindb import SmartBinDB

db = SmartBinDB()

async def main():
    result = await db.aget_bins_by_country("BD", limit=20)
    print("Total:", result["count"])
    for entry in result["data"][:5]:
        print(entry["bin"], entry["issuer"])

asyncio.run(main())

Inspect ISO country metadata

from smartbindb import SmartBinDB

db = SmartBinDB()
print(db.get_country_info("US"))
print(db.get_country_info("DE"))
print(db.get_country_info("BD"))