# Card information by BIN

With this API request, you will be able to find out the BIN information of the card.

```
https://unitpay.ru/api?
     method=getBinInfo
     params[login]=partner@mail
     params[bin]=477964
     params[secretKey]=key
```

<table data-header-hidden><thead><tr><th width="161.55550130208331">name</th><th width="145.2222900390625">type</th><th>description</th></tr></thead><tbody><tr><td><strong>login</strong></td><td>string</td><td>Email associated with the UnitPay system</td></tr><tr><td><strong>secretKey</strong></td><td>string</td><td>Partner's secret key, available in <a href="https://unitpay.money/partner/profile/edit">profile settings</a></td></tr><tr><td><strong>bin</strong></td><td>number</td><td>First 6 digits of the card number</td></tr></tbody></table>

#### Successful response

```
{"result": {
    "bin": "477964",
    "bank": "Alfa Bank",
    "countryCode": "RU",
    "brand": "VISA",
    "category": "CLASSIC",
    "bankUrl": "http://alfabank.com/russia/",
    "bankPhone": "7 495 620-91-91"
}}
```

<table data-header-hidden><thead><tr><th width="171.55556233723956">name</th><th width="125.7777099609375">type</th><th>description</th></tr></thead><tbody><tr><td><strong>bin</strong></td><td>string</td><td>First 6 digits of the card number</td></tr><tr><td><strong>bank</strong></td><td>string</td><td>Name of the bank where the card was issued</td></tr><tr><td><strong>countryCode</strong></td><td>string</td><td>Country code in Alpha-2 format (ISO 3166-1)</td></tr><tr><td><strong>brand</strong></td><td>string</td><td>Name of the international system in which the card is serviced</td></tr><tr><td><strong>category</strong></td><td>string</td><td>Категория карты</td></tr><tr><td><strong>type</strong></td><td>string</td><td>Card type</td></tr><tr><td><strong>bankUrl</strong></td><td>string</td><td>Bank url</td></tr><tr><td><strong>bankPhone</strong></td><td>string</td><td>Bank phone number</td></tr></tbody></table>

#### Example of an incorrect answer

```
{"error": {
    "message": "Nothing was found for your request",
    "code": 100
}}
```

<table data-header-hidden><thead><tr><th width="138.4444580078125">name</th><th width="138.22224934895831">type</th><th>description</th></tr></thead><tbody><tr><td><strong>message</strong></td><td>string</td><td>Information describing the request error</td></tr><tr><td><strong>code</strong></td><td>string</td><td>Error code, detailed decoding in the table below</td></tr></tbody></table>

#### Description of errors

<table data-header-hidden><thead><tr><th width="136.22222900390625"></th><th>Описание</th></tr></thead><tbody><tr><td><strong>100</strong></td><td>Nothing was found for your request</td></tr></tbody></table>

#### Technical errors:

<table data-header-hidden><thead><tr><th width="137.33331298828125">name</th><th>description</th></tr></thead><tbody><tr><td><strong>-32000</strong></td><td>Invalid authorisation parameters (login, secret key)</td></tr><tr><td><strong>-32602</strong></td><td>Invalid query parameters</td></tr><tr><td><strong>-32603</strong></td><td>Internal technical error</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.unitpay.ru/en/mass-payouts/card-information-by-bin.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.