---
title: "Search & Filter BIN Database API"
slug: bin-search
url: https://apyhub.com/quadlem/service/bin-search
provider: "Quadlem, LLC"
categories: [Data Validation, Finance]
tags: [bin-lookup, card-validation, payment-routing, issuer-data, card-brand]
auth: api_key
version: 2.1.0
service_type: sync
endpoints: 1
atoms: 40
mcp: true
---

# Search & Filter BIN Database API

Search BIN records by bank, brand, country, prefix, level, or card type. Returns a response envelope with a success flag, code, and module blocks.

## Endpoints

| Method | URL | Description | Atoms |
| --- | --- | --- | --- |
| GET | `https://api.eu.apyhub.com/quadlem/bin-search` | What it does Searches the BIN database by attribute filters — brand, bank, card type, level, countr… | 40 |

## Endpoint reference

### BIN Search

`GET https://api.eu.apyhub.com/quadlem/bin-search` · 40 atoms · accepts `application/json` · returns `application/json`

| Parameter | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `bank` | query | string | no |  |
| `type` | query | string | no | One of: DEBIT, CREDIT, CHARGE. |
| `brand` | query | string | no |  |
| `level` | query | string | no |  |
| `limit` | query | integer | no | Default: `25`. |
| `offset` | query | integer | no | Default: `0`. |
| `prefix` | query | string | no |  |
| `country` | query | string | no |  |
| `bankExact` | query | string | no |  |
| `withTotal` | query | string | no | One of: 1. |

#### Quickstart

Use the following request to browse BIN records and filter them by card type. Pagination parameters let you retrieve the results in manageable pages.

```bash
curl -X GET "https://api.eu.apyhub.com/quadlem/bin-search?type=DEBIT&limit=25&offset=0&withTotal=1" \
  -H "apy-token: $APY_TOKEN"
```

#### What you'll get back

A successful request returns a paginated list of BIN records matching the specified filters, along with pagination metadata.

```json
{
  "success": true,
  "code": 200,
  "count": 25,
  "hasMore": true,
  "limit": 25,
  "offset": 0,
  "results": [
    {
      "number": 10051,
      "bin": 10051,
      "scheme": "EXAMPLE BRAND",
      "type": "DEBIT",
      "currency": "EUR",
      "issuer": {
        "name": ""
      },
      "country": {
        "name": "ITALY",
        "alpha2": "IT",
        "currency": "EUR"
      }
    }
  ]
}
```

> **Note:** The `results` array is truncated in this example. The full response returns up to the specified `limit` of BIN records per page. Use the `offset` parameter to retrieve additional pages of results.

## About

## What it does
BIN Lookup helps you search card issuer data by bank and card attributes. Send query parameters such as `bank`, `type`, `brand`, `level`, `prefix`, `country`, or `bankExact`, and get back a response envelope with a numeric `code`, a `success` flag, and module blocks.

Use it when you need to check a card prefix against issuer metadata before accepting a payment, filtering test card sets, or grouping payment traffic by brand or card type. The search supports pagination with `limit` and `offset`, and can optionally include total counts with `withTotal=1`.

The `type` filter accepts `DEBIT`, `CREDIT`, or `CHARGE`, which makes it useful for payment flows that need to distinguish card classes. You can combine filters to narrow results by bank name, exact bank name, country, brand, or level.

BIN Lookup is a lightweight way to query BIN-related records without parsing payment data yourself. It is useful anywhere you need issuer lookup, card classification, or BIN-based filtering in real time.

## Usage

Base URL: `https://api.eu.apyhub.com` (default region — see
`GET https://apyhub.com/api/public/regions` for the rest).

Authenticate with an ApyHub API key in the `apy-token` header.
Full docs and a live playground: https://apyhub.com/quadlem/service/bin-search