# Quick Start Guide source: https://developer.mastercard.com/bin-lookup/documentation/quick-start-guide/index.md ###### Time to complete: 10 minutes ## Overview {#overview} Use this guide to go from account setup to your first successful Sandbox request for BIN Lookup. You will create a project, generate credentials, make a test call, and prepare the same project for Production access. Tip: For the fastest path to a working Sandbox request, start with the [Postman Collections](https://developer.mastercard.com/bin-lookup/documentation/developer-tools/postman-collection/index.md) page. You can use it to test Sandbox and Production flows before you write any code. ### Prerequisites {#prerequisites} For this tutorial you must ensure you have `Python` and `pip` installed on your system. If you don't already have Python installed, check out the [Python documentation](https://www.python.org/doc/). ### Checklist {#checklist} | # | Step | What to do | |----------------------------------------------------------------------------------------------------------------------------------------------------|----------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | [1](https://developer.mastercard.com/bin-lookup/documentation/quick-start-guide/index.md#step-1-get-access-to-mastercard-developers) | Access | Get access to Mastercard Developers. | | [2](https://developer.mastercard.com/bin-lookup/documentation/quick-start-guide/index.md#step-2-create-a-project-and-generate-sandbox-credentials) | Project | Create a Mastercard Developers project and get access to BIN Lookup. | | [3](https://developer.mastercard.com/bin-lookup/documentation/quick-start-guide/index.md#step-3-authentication) | Authentication | Create a Mastercard OAuth signer. | | [4](https://developer.mastercard.com/bin-lookup/documentation/quick-start-guide/index.md#step-4-make-your-first-sandbox-request) | First call | Send your first Sandbox request using the Sandbox base URL and OAuth 1.0a signing. | | 5 | Validation | Use the sample response and [Testing](https://developer.mastercard.com/bin-lookup/documentation/testing/index.md) page to validate test data, positive flows, and negative flows. | | 6 | Production | After Sandbox validation is complete, use the [Onboarding Checklist](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/onboarding-checklist/index.md) to request Production access. | ## Step 1: Get Access to Mastercard Developers {#step-1-get-access-to-mastercard-developers} 1. Go to [Mastercard Developers](https://developer.mastercard.com/account/log-in), then log in or create an account. 2. Activate a new account by opening the link sent to your email address and log in. ## Step 2: Create a Project and Generate Sandbox Credentials {#step-2-create-a-project-and-generate-sandbox-credentials} Create a Mastercard Developers project to generate your Sandbox credentials. Sandbox provides mocked data so that you can validate your integration before requesting Production access. ### Project Details {#project-details} 1. Click **Create new project** on your [My Projects](https://developer.mastercard.com/dashboard) page. ![BIN Lookup Project Creation](https://static.developer.mastercard.com/content/bin-lookup/img/project-details.png) 2. Enter a project name. 3. Indicate whether you are creating the project on behalf of a client. 4. In the **Select at least one API** field, choose **BIN Lookup** and click **Proceed**. ### Project Credentials {#project-credentials} 5. On the **Project Credentials** page, create a key alias and keystore password for your OAuth keys, record them securely, and click **Create Project**. ![BIN Lookup Project Credentials](https://static.developer.mastercard.com/content/bin-lookup/img/project-credentials.png) ### Additional Credentials {#additional-credentials} 6. Download the OAuth 1.0a key file and store in a safe place. 7. Click **Open Project** . ![Project creation confirmation with key download links](https://static.developer.mastercard.com/content/bin-lookup/img/project-creation.png) ### Save the Values you Will Need {#save-the-values-you-will-need} 8. From the project dashboard, record the Sandbox consumer key. ![Sandbox consumer key](https://static.developer.mastercard.com/content/bin-lookup/img/consumer-key.png) ## Step 3: Authentication {#step-3-authentication} Mastercard uses OAuth 1.0a to authenticate your application. Mastercard provides [client authentication libraries](https://github.com/Mastercard?q=oauth) in several languages that you can integrate to your project or use as reference OAuth 1.0a implementations: | | ![Java](https://static.developer.mastercard.com/content/bin-lookup/img/java.svg) **Java** | ![C#](https://static.developer.mastercard.com/content/bin-lookup/img/csharp.svg) **C#** | ![Python](https://static.developer.mastercard.com/content/bin-lookup/img/python.svg) **Python** | ![NodeJS](https://static.developer.mastercard.com/content/bin-lookup/img/nodejs.svg) **NodeJS** | ![Go](https://static.developer.mastercard.com/content/bin-lookup/img/go.svg) **Go** | |----------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|--------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------| | **Download/install** | [![](https://img.shields.io/maven-central/v/com.mastercard.developer/oauth1-signer.svg?style=flat&color=f99f1c&label=)](https://search.maven.org/artifact/com.mastercard.developer/oauth1-signer/) | [![](https://img.shields.io/nuget/v/Mastercard.Developer.OAuth1Signer.Core.svg?style=flat&color=f99f1c&label=)](https://www.nuget.org/packages/Mastercard.Developer.OAuth1Signer.RestSharpV2/) | [![](https://img.shields.io/pypi/v/mastercard-oauth1-signer.svg?style=flat&color=f99f1c&label=)](https://pypi.org/project/mastercard-oauth1-signer/) | [![](https://img.shields.io/npm/v/mastercard-oauth1-signer.svg?style=flat&color=f99f1c&label=)](https://www.npmjs.com/package/mastercard-oauth1-signer) | [![](https://img.shields.io/github/v/release/mastercard/oauth1-signer-go.svg?style=flat&color=f99f1c&label=)](https://github.com/Mastercard/oauth1-signer-go) | | **View on GitHub** | [![](https://img.shields.io/github/stars/mastercard/oauth1-signer-java.svg?label=&style=social)](https://github.com/Mastercard/oauth1-signer-java) | [![](https://img.shields.io/github/stars/mastercard/oauth1-signer-csharp.svg?label=&style=social)](https://github.com/Mastercard/oauth1-signer-csharp) | [![](https://img.shields.io/github/stars/mastercard/oauth1-signer-python.svg?label=&style=social)](https://github.com/Mastercard/oauth1-signer-python) | [![](https://img.shields.io/github/stars/mastercard/oauth1-signer-nodejs.svg?label=&style=social)](https://github.com/Mastercard/oauth1-signer-nodejs) | [![](https://img.shields.io/github/stars/mastercard/oauth1-signer-go.svg?label=&style=social)](https://github.com/Mastercard/oauth1-signer-go) | This guide uses Python to demonstrate how to use the Mastercard authentication library. For other languages, follow the README files on GitHub. 1. Install the `oauth signer` and the Python `requests` library using `pip`, via your command terminal: ```cmd pip install mastercard-oauth1-signer requests ``` 2. Create a Python file, let's call it `binlookup.py`. Once the file is created, add the following imports: ```python import requests from requests.auth import AuthBase import oauth1.authenticationutils as authenticationutils from oauth1.signer import OAuthSigner ``` 3. Create a helper class using `AuthBase` from the `Requests` library that automatically signs all of the HTTP requests we send: ```python # MCSigner # Helper class for signing request objects class MCSigner(AuthBase): def __init__(self, consumer_key, signing_key): self.signer = OAuthSigner(consumer_key, signing_key) def __call__(self, request): self.signer.sign_request(request.url, request) return request ``` 4. Use the `load_signing_key` function to create a signing key using the .p12 key file that you downloaded from Mastercard Developers and your keystore password: ```python signing_key = authenticationutils.load_signing_key('./path/to/projectname-sandbox.p12', 'keystorepassword') ``` 5. Use the `MCSigner` helper class to create our HTTP request signer using the consumer key of your Mastercard Developers project: ```python base_url = 'https://sandbox.api.mastercard.com/bin-resources' # URL for BIN Lookup API Sandbox consumer_key = 'consumer key' signer = MCSigner(consumer_key, signing_key) ``` We now have everything we need to authenticate a request. For a detailed overview of the OAuth 1.0a approach Mastercard uses, refer to [Using OAuth 1.0a to Access Mastercard APIs](https://developer.mastercard.com/platform/documentation/authentication/using-oauth-1a-to-access-mastercard-apis/). In the next step we will create and call a method to download all data from the paginated full download endpoint. ## Step 4: Make Your First Sandbox Request {#step-4-make-your-first-sandbox-request} Once you have Sandbox credentials, make a simple request to confirm that your project is set up correctly. This first-call example uses `bin-ranges/`, so you can verify access, OAuth signing, and the Sandbox base URL before moving on. For more information about this endpoint, see the [API Reference](https://developer.mastercard.com/bin-lookup/documentation/api-reference/index.md#all-data-including-filtering). ### curl Example {#curl-example} ```cli curl -X POST https://sandbox.api.mastercard.com/bin-resources/bin-ranges/ ``` Warning: The curl example above does not include OAuth signing. For a working curl call, use the [Postman Collection](https://developer.mastercard.com/bin-lookup/documentation/developer-tools/postman-collection/index.md) or the [Python example](https://developer.mastercard.com/bin-lookup/documentation/quick-start-guide/index.md#using-python) which handles signing using the `MCSigner` helper class described in [Authentication](https://developer.mastercard.com/bin-lookup/documentation/quick-start-guide/index.md#step-3-authentication). ### Using Python {#using-python} To call BIN Lookup and download all BIN data, add the following to your `binlookup.py` file after the signer setup: ```python # Make a single BIN lookup call to verify your setup response = requests.post( f'{base_url}/bin-ranges', auth=signer ) print(response.json()) ``` Run the complete Python script with: ```cli python binlookup.py ``` ### Expected Response {#expected-response} A successful call returns a JSON array containing the first page of available BIN data. You should see a response similar to: ```cmd {'id': 52, 'currentPageNumber': 1, 'currentPageSize': 25, 'totalPages': 4296, 'totalItems': 107394, 'items': [{'lowAccountRange': 1111020000000000000, 'highAccountRange': 1111029999999999999, 'binNum': '111102', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '9291', 'customerName': 'ARAB BANK PLC', 'smartDataEnabled': False, 'country': {'code': 860, 'alpha3': 'UZB', 'name': 'Uzbekistan'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'CIR', 'productDescription': 'CIRRUS', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111024300000000000, 'highAccountRange': 1111024399999999999, 'binNum': '111102', 'binLength': 6, 'acceptanceBrand': 'CIR', 'ica': '30925', 'customerName': 'NVAYO LIMITED', 'smartDataEnabled': False, 'country': {'code': 826, 'alpha3': 'GBR', 'name': 'United Kingdom of Great Britain and Northern Ireland'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MRH', 'productDescription': 'MASTERCARD PREPAID PLATINUM TRAVEL', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'CREDIT', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111030800000000000, 'highAccountRange': 1111030899999999999, 'binNum': '111103', 'binLength': 6, 'acceptanceBrand': 'DMC', 'ica': '22045', 'customerName': 'JOINT STOCK COMPANY HALYK BANK OF KAZAKHSTAN', 'smartDataEnabled': False, 'country': {'code': 466, 'alpha3': 'MLI', 'name': 'Mali'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MDS', 'productDescription': 'DEBIT STANDARD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111085851000000000, 'highAccountRange': 1111085851999999999, 'binNum': '11110858', 'binLength': 8, 'acceptanceBrand': 'DMC', 'ica': '21014', 'customerName': 'STRIPE PAYMENTS UK LIMITED', 'smartDataEnabled': False, 'country': {'code': 554, 'alpha3': 'NZL', 'name': 'New Zealand'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MPL', 'productDescription': 'PLATINUM', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'CREDIT', 'consumerType': 'CONSUMER', 'affiliate': 'Shoreline Credit Union', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111150000000000000, 'highAccountRange': 1111159999999999999, 'binNum': '111115', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '31025', 'customerName': 'JOINT STOCK COMPANY "SIAULIU BANKAS"', 'smartDataEnabled': False, 'country': {'code': 226, 'alpha3': 'GNQ', 'name': 'Equatorial Guinea'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MCS', 'productDescription': 'STANDARD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111170000000000000, 'highAccountRange': 1111179999999999999, 'binNum': '111117', 'binLength': 6, 'acceptanceBrand': 'PVL', 'ica': '14978', 'customerName': 'THINK MONEY LIMITED', 'smartDataEnabled': False, 'country': {'code': 250, 'alpha3': 'FRA', 'name': 'France'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MSI', 'productDescription': 'MAESTRO', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'NONE', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111172200000000000, 'highAccountRange': 1111172299999999999, 'binNum': '111117', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '9287', 'customerName': 'CHOICE FInullCIAL GROUP', 'smartDataEnabled': False, 'country': {'code': 616, 'alpha3': 'POL', 'name': 'Poland'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MDG', 'productDescription': 'DEBIT GOLD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'NONE', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111208700000000000, 'highAccountRange': 1111208799999999999, 'binNum': '111120', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '20240', 'customerName': 'ZEMPLER BANK LIMITED', 'smartDataEnabled': False, 'country': {'code': 233, 'alpha3': 'EST', 'name': 'Estonia'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MPL', 'productDescription': 'PLATINUM', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111247700000000000, 'highAccountRange': 1111247799999999999, 'binNum': '111124', 'binLength': 6, 'acceptanceBrand': 'DMC', 'ica': '6401', 'customerName': 'ALLY BANK', 'smartDataEnabled': False, 'country': {'code': 524, 'alpha3': 'NPL', 'name': 'Nepal'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MLC', 'productDescription': 'MASTERCARD MICRO BUSINESS CARD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'PREPAID', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111360000000000000, 'highAccountRange': 1111369999999999999, 'binNum': '111136', 'binLength': 6, 'acceptanceBrand': 'MSI', 'ica': '31010', 'customerName': 'AGRIBANK, FCB', 'smartDataEnabled': True, 'country': {'code': 430, 'alpha3': 'LBR', 'name': 'Liberia'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MCO', 'productDescription': 'MASTERCARD CORPORATE', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111372100000000000, 'highAccountRange': 1111372399999999999, 'binNum': '111137', 'binLength': 6, 'acceptanceBrand': 'DMC', 'ica': '17704', 'customerName': 'CAIXA ECONOMICA FEDERAL', 'smartDataEnabled': False, 'country': {'code': 470, 'alpha3': 'MLT', 'name': 'Malta'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MRW', 'productDescription': 'MASTERCARD PREPAID BUSINESS NON US', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'CREDIT', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111422300000000000, 'highAccountRange': 1111422399999999999, 'binNum': '111142', 'binLength': 6, 'acceptanceBrand': 'DMC', 'ica': '33135', 'customerName': 'BANCO MUNICIPAL DE ROSARIO', 'smartDataEnabled': False, 'country': {'code': 410, 'alpha3': 'KOR', 'name': 'Korea (the Republic of)'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MDT', 'productDescription': 'COMMERCIAL DEBIT', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'CREDIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111470000000000000, 'highAccountRange': 1111470099999999999, 'binNum': '11114700', 'binLength': 8, 'acceptanceBrand': 'CIR', 'ica': '13557', 'customerName': 'PAYPORTER ODEME HIZMETLERI VE ELEKTRONIK PARA AS', 'smartDataEnabled': False, 'country': {'code': 0, 'alpha3': None, 'name': 'Unidentified country'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MDS', 'productDescription': 'DEBIT STANDARD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'NONE', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111500000000000000, 'highAccountRange': 1111509999999999999, 'binNum': '111150', 'binLength': 6, 'acceptanceBrand': 'CIR', 'ica': '19011', 'customerName': 'HSBC BANK (VIETNAM) LTD.', 'smartDataEnabled': False, 'country': {'code': 410, 'alpha3': 'KOR', 'name': 'Korea (the Republic of)'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MCB', 'productDescription': 'BUSINESSCARD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'PREPAID', 'consumerType': 'CORPORATE', 'affiliate': 'Public Joint Stock Company "MTB Bank"', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111512300000000000, 'highAccountRange': 1111512399999999999, 'binNum': '111151', 'binLength': 6, 'acceptanceBrand': 'PVL', 'ica': '17894', 'customerName': 'STOPANSKA BANKA A.D BITOLA', 'smartDataEnabled': False, 'country': {'code': 643, 'alpha3': 'RUS', 'name': 'Russian Federation'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MPB', 'productDescription': 'MASTERCARD PREFERRED BUSINESSCARD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'CREDIT', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111563500000000000, 'highAccountRange': 1111563599999999999, 'binNum': '111156', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '6988', 'customerName': 'TAIWAN SHIN KONG COMMERCIAL BANK CO., LTD.', 'smartDataEnabled': False, 'country': {'code': 834, 'alpha3': 'TZA', 'name': 'Tanzania, the United Republic of'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MRG', 'productDescription': 'MASTERCARD PREPAID NON US GENERAL SPEND', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'NONE', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111690900000000000, 'highAccountRange': 1111690901999999999, 'binNum': '111169', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '14975', 'customerName': 'ASOCIACION MUTUALISTA DE A/C PARA LA VIVIENDA PICHINCHA', 'smartDataEnabled': False, 'country': {'code': 562, 'alpha3': 'NER', 'name': 'Niger'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MCC', 'productDescription': 'MASTERCARD MIXED', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111750000000000000, 'highAccountRange': 1111759999999999999, 'binNum': '111175', 'binLength': 6, 'acceptanceBrand': 'PVL', 'ica': '17245', 'customerName': 'AFFIN BANK BERHAD', 'smartDataEnabled': False, 'country': {'code': 430, 'alpha3': 'LBR', 'name': 'Liberia'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MCT', 'productDescription': 'TITANIUM MASTERCARD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111783700000000000, 'highAccountRange': 1111783799999999999, 'binNum': '111178', 'binLength': 6, 'acceptanceBrand': 'CIR', 'ica': '14491', 'customerName': 'CREDIT SAISON CO., LTD.', 'smartDataEnabled': False, 'country': {'code': 434, 'alpha3': 'LBY', 'name': 'Libya'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MCW', 'productDescription': 'WORLD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'CREDIT', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111819600000000000, 'highAccountRange': 1111819699999999999, 'binNum': '111181', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '13237', 'customerName': 'FINECOBANK SPA', 'smartDataEnabled': False, 'country': {'code': 426, 'alpha3': 'LSO', 'name': 'Lesotho'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MPW', 'productDescription': 'MASTERCARD PREPAID WORKPLACE B2B', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'NONE', 'consumerType': 'CORPORATE', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111841500000000000, 'highAccountRange': 1111841599999999999, 'binNum': '111184', 'binLength': 6, 'acceptanceBrand': 'PVL', 'ica': '3496', 'customerName': 'BANCA SAMMARINESE DI INVESTIMENTO SPA', 'smartDataEnabled': False, 'country': {'code': 454, 'alpha3': 'MWI', 'name': 'Malawi'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MRG', 'productDescription': 'MASTERCARD PREPAID NON US GENERAL SPEND', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'NONE', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111841800000000000, 'highAccountRange': 1111841899999999999, 'binNum': '111184', 'binLength': 6, 'acceptanceBrand': 'MCC', 'ica': '19386', 'customerName': 'RELYANCE BANK', 'smartDataEnabled': False, 'country': {'code': 504, 'alpha3': 'MAR', 'name': 'Morocco'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MCG', 'productDescription': 'GOLD', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'CREDIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111848100000ype': 'P', 'mastercardOneParticipationIndicator': 'N'}, {'lowAccountRange': 1111910000000000000, 'highAccountRange': 1111919999999999999, 'binNum': '111191', 'binLength': 6, 'acceptanceBrand': 'CIR', 'ica': '17820', 'customerName': 'ZENITH BANK', 'smartDataEnabled': False, 'country': {'code': 512, 'alpha3': 'OMN', 'name': 'Oman'}, 'localUse': False, 'authorizationOnly': False, 'productCode': 'MPL', 'productDescription': 'PLATINUM', 'governmentRange': False, 'nonReloadableIndicator': False, 'anonymousPrepaidIndicator': 'N', 'cardholderCurrencyIndicator': 'D', 'billingCurrencyDefault': 'XXX', 'comboCardIndicator': 'N', 'flexCardIndicator': 'N', 'fasterFundsIndicator': None, 'moneySendIndicator': 'N', 'gamblingBlockEnabled': None, 'programName': 'UNAVAILABLE', 'vertical': 'UNAVAILABLE', 'fundingSource': 'DEBIT', 'consumerType': 'CONSUMER', 'affiliate': 'UNAVAILABLE', 'paymentAccountType': 'P', 'mastercardOneParticipationIndicator': 'N'}]} ``` To learn more about the data elements returned, see [API Data Elements](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/data-elements/api-data-elements/index.md#account-range-data). If you receive a similar JSON array, your credentials and authentication are working correctly. You have now successfully called the BIN Lookup service. See [Testing](https://developer.mastercard.com/bin-lookup/documentation/testing/index.md) for additional information. ## Next Steps {#next-steps} Now that you have successfully connected to the BIN Lookup service, here are some next steps: * **Single BIN Lookup:** Learn how to check a single BIN at a time with the [single lookup tutorial](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/single-lookup/index.md). * **Filtering:** Learn to filter data by issuer, country, or product code with the [filtering tutorial](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/filtering-tutorial/index.md). * **API Reference:** Review the full [API specification](https://developer.mastercard.com/bin-lookup/documentation/api-reference/index.md). * **Data Elements:** Understand what data is available across [different tiers](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/data-elements/index.md). * **Go to Production:** When you are ready, follow the [onboarding checklist](https://developer.mastercard.com/bin-lookup/documentation/tutorials-and-guides/onboarding-checklist/index.md) and review [available plans](https://developer.mastercard.com/bin-lookup/documentation/pricing-plans/index.md) to request production access.