# `Worldpay.CardBIN`
[🔗](https://github.com/iamkanishka/worldpay/blob/v1.0.0/lib/worldpay/access/data.ex#L63)

Worldpay **Card BIN API** — issuer, scheme, and capability lookup.

Accepts first 6 or 8 digits of a PAN.

## Response fields

- `brand` — list of card brand strings (multi-brand for co-badged)
- `fundingType` — `"credit"` | `"debit"` | `"prepaid"` | `"chargeCard"` | `"deferredDebit"`
- `issuerName` — issuing bank name
- `countryCode` — ISO 3166-1 Alpha-2
- `dccAllowed` — boolean
- `anonymousPrepaid` — boolean
- `category` — `"consumer"` | `"commercial"`

# `lookup`

```elixir
@spec lookup(String.t(), Worldpay.Config.t()) ::
  {:ok, map()} | {:error, Worldpay.Error.t()}
```

BIN lookup v1.

# `lookup_v2`

```elixir
@spec lookup_v2(String.t(), Worldpay.Config.t()) ::
  {:ok, map()} | {:error, Worldpay.Error.t()}
```

BIN lookup v2 (Apr 2026 — expanded response).

---

*Consult [api-reference.md](api-reference.md) for complete listing*