# CardBinCheck

> Look up a payment card from its first 6 to 8 digits (its BIN or IIN): the card network, whether it is credit, debit or prepaid, the issuing bank and the country it was issued in. Check one card or a whole list at once, to flag foreign cards or route payments. No account or API key required.

App · 2 actions. Web page: https://docs.lodol.com/docs/integrations/cardbincheck

## Actions

### Look up a card BIN

Find out about a payment card from its first 6 to 8 digits (its BIN): the card network, whether it is a credit, debit or prepaid card, the bank that issued it and the country it comes from. Use it to spot a card from another country than the customer's, or to tell debit from credit before you charge. A whole card number can be given; only its first 8 digits are sent. No API key required.

**Inputs**

- Card number or BIN (`card_number`, text, required): The first 6 to 8 digits of the card, for example 45717360. A whole card number works too: spaces and hyphens are ignored, and only the first 8 digits are sent.

**Outputs**

- `bank_phone` (text): The issuing bank's customer service phone number, when CardBinCheck has it.
- `bank_website` (text): The issuing bank's website, when CardBinCheck has it.
- `bin` (text): The BIN CardBinCheck matched, which can be shorter than the digits looked up (42424242 matches 424242).
- `bin_searched` (text): The digits that were looked up: the first 6 to 8 digits of what was given. The rest of a card number is never sent.
- `card_level` (text): The card's product level, such as Classic, Gold, Platinum or Business. Empty when CardBinCheck does not know it.
- `card_type` (text): Credit, Debit, Prepaid or Charge Card.
- `country_code` (text): The two-letter code of the country the card was issued in.
- `country_name` (text): The name of the country the card was issued in.
- `details_url` (text): CardBinCheck's page for this BIN.
- `found` (true/false): Whether CardBinCheck knows this BIN. When false, every card detail is empty and the message says why.
- `issuing_bank` (text): The bank or financial institution that issued the card. Empty when CardBinCheck does not know it.
- `message` (text): Why the BIN was not found or could not be looked up. Empty when it was found.
- `network` (text): The card network, such as Visa, Mastercard, American Express, Discover or JCB.

**Example output**

```json
{
  "bank_phone": "89 89 89 89",
  "bank_website": "https://www.jyskebank.dk",
  "bin": "45717360",
  "bin_searched": "45717360",
  "card_level": "Dankort",
  "card_type": "Debit",
  "country_code": "DK",
  "country_name": "Denmark",
  "details_url": "https://cardbincheck.com/bin/45717360",
  "found": true,
  "issuing_bank": "Jyske Bank",
  "message": "",
  "network": "Visa"
}
```

### Look up several card BINs

Look up a whole list of BINs or card numbers in one step, such as a column of payments, and get back each card's network, type, issuing bank and country, plus how many were found. A BIN that is unknown or mistyped comes back as a row saying so rather than failing the step. Up to 100 at a time, and it uses far less of the daily allowance than looking them up one by one. No API key required.

**Inputs**

- Card numbers or BINs (`card_numbers`, list, required): Up to 100 BINs or card numbers. Only the first 8 digits of each are sent. Several in one entry, separated by commas or line breaks, are split apart.

**Outputs**

- `count` (number): How many BINs were looked up.
- `found_count` (number): How many of them CardBinCheck knows.
- `not_found_count` (number): How many were unknown or not valid card numbers.
- `results` (list): One row per BIN, in the order they were given, so the rows line up with the list that was sent.

**Example output**

```json
{
  "count": 3,
  "found_count": 2,
  "not_found_count": 1,
  "results": [
    {
      "bank_phone": "89 89 89 89",
      "bank_website": "https://www.jyskebank.dk",
      "bin": "45717360",
      "bin_searched": "45717360",
      "card_level": "Dankort",
      "card_type": "Debit",
      "country_code": "DK",
      "country_name": "Denmark",
      "details_url": "https://cardbincheck.com/bin/45717360",
      "found": true,
      "issuing_bank": "Jyske Bank",
      "message": "",
      "network": "Visa"
    },
    {
      "bank_phone": "",
      "bank_website": "",
      "bin": "511332",
      "bin_searched": "511332",
      "card_level": "",
      "card_type": "Credit",
      "country_code": "US",
      "country_name": "United States",
      "details_url": "https://cardbincheck.com/bin/511332",
      "found": true,
      "issuing_bank": "Chase Manhattan Bank USA, N.A.",
      "message": "",
      "network": "Mastercard"
    },
    {
      "bank_phone": "",
      "bank_website": "",
      "bin": "",
      "bin_searched": "000000",
      "card_level": "",
      "card_type": "",
      "country_code": "",
      "country_name": "",
      "details_url": "",
      "found": false,
      "issuing_bank": "",
      "message": "This BIN is not in CardBinCheck's database.",
      "network": ""
    }
  ]
}
```