# Filtered Searches
source: https://developer.mastercard.com/bin-lookup/documentation/use-cases/bin-search/index.md

## BIN Search {#bin-search}

This API allows BIN Lookup integrators (Merchants/Acquirers/Payment Service Providers - PSPs/Fintechs) to search for BIN range information based on a key/value pair.

### Request {#request}

**POST** {{baseurl}}/bin-ranges

```json
[
  {
  "key": "customerName",
  "value": "CITI"
  }
]
```

### Response {#response}

```json
{
  "currentPageNumber": 1,
  "currentPageSize": 2,
  "totalPages": 1,
  "totalRecords": 2,
  "items": [
    {
      "lowAccountRange": 2229293150000000000,
      "highAccountRange": 2229293200000000000,
      "binNum": "222929",
      "binLength": 6,
      "acceptanceBrand": "MCC",
      "ica": "00000023460",
      "customerName": "CITIBANK N.A.",
      "country": {
                "code": 360,
                "alpha3": "IDN",
                "name": "Indonesia"
            },
      "localUse": false,
      "authorizationOnly": false,
      "productCode": "MCO",
      "productDescription": "MASTERCARD CORPORATE",
      "nonReloadableIndicator": false,
      "anonymousPrepaidIndicator": "N",
      "programName": null,
      "vertical": null,
      "fundingSource": "CREDIT",
      "consumerType": "CONSUMER",
      "smartDataEnabled": true,
      "affiliate": null,
      "comboCardIndicator": "N",
      "flexCardIndicator": "N",
      "gamblingBlockEnabled": false,
      "paymentAccountType": "P"
    },
    {
      "lowAccountRange": 2184415000000000000,
      "highAccountRange": 2184416000000000000,
      "binNum": "218441",
      "binLength": 6,
      "acceptanceBrand": "MSI",
      "ica": "00000002535",
      "customerName": "CITIBANK EUROPE",
      "country": {
                "code": 840,
                "alpha3": "USA",
                "name": "United States of America"
            },
      "localUse": false,
      "authorizationOnly": false,
      "productCode": "MSI",
      "productDescription": "MAESTRO",
      "nonReloadableIndicator": false,
      "anonymousPrepaidIndicator": "N",
      "programName": null,
      "vertical": null,
      "fundingSource": "DEBIT",
      "consumerType": "CONSUMER",
      "smartDataEnabled": true,
      "affiliate": null,
      "comboCardIndicator": "N",
      "flexCardIndicator": "N",
      "gamblingBlockEnabled": false,
      "paymentAccountType": "P"
    }
  ]
}
```

### Example Sequence {#example-sequence}

The following example sequence shows how you might use the BIN Search API.

![How to filter BINs](https://static.developer.mastercard.com/content/bin-lookup/uploads/binsearch.svg "How to filter BINs")

## Next Steps {#next-steps}

To learn how to use the filtering functionality check out the following [tutorial](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/filtering-tutorial/index.md).

### Useful Links {#useful-links}

* View the full Open API specification [here](https://developer.mastercard.com/bin-lookup/documentation/api-section/api-reference/index.md).
* Review the API's error responses [here](https://developer.mastercard.com/bin-lookup/documentation/code-and-formats/index.md).