# BIN

BIN (Bank Identification Number) lookup is an essential tool to verify payment transactions, prevent fraudulent activities, and ensure seamless payment processing. This service provides valuable insights into the issuing bank, card type, and geographic location associated with a given payment card, enabling businesses to make informed decisions and enhance security measures.

##  bin\_lookup

<mark style="color:green;">`POST`</mark> `https://secctrl.tutelar.io/api/v1/services/business_profile/bin_lookup`

### Post parameters description is given below,

<table><thead><tr><th>Body</th><th width="148">Type</th><th>Mandatory</th><th>Description</th></tr></thead><tbody><tr><td>bin_number</td><td>String</td><td>Yes</td><td>BIN Number</td></tr></tbody></table>

#### Sample Request Body

```json
{
  "bin_number": "100001"
}
```

{% tabs %}
{% tab title="200: Success Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request has been successfully completed.",
    "reference_id": "d4269f43-9443-4c5a-bc4a-60b4bafdd04c",
    "status": "completed",
    "result": {
        "bin": "100001",
        "brand": "LOCAL BRAND",
        "bank": "STATE BANK OF INDIA",
        "type": "DEBIT",
        "sub_brand": "CLASSIC",
        "country": "INDIA",
        "iso_1": "IN",
        "iso_2": "IND",
        "iso_3": "356"
    },
    "requested_at": "2024-03-19T06:44:25.255Z",
    "completed_at": "2024-03-19T06:44:25.318Z"
}
```

{% endtab %}

{% tab title="400: Validation Error Response" %}

```json
{
    "success": false,
    "code": 400,
    "message": "Invalid input. Please check your request and try again.",
    "error": {
        "message": "BIN Number should not be empty",
        "field": "bin_number",
        "code": "BAD_REQUEST"
    }
}
```

{% endtab %}

{% tab title="200: Failure Response" %}

```json
{
    "success": true,
    "code": 200,
    "message": "The request could not be completed due to an error.",
    "reference_id": "f04aa55e-9bed-4c9e-9bb8-7412a633cb01",
    "status": "failed",
    "error": {
        "message": "Card lookup not found or invalid. Please review the card information for accuracy.",
        "code": "ERROR"
    },
    "requested_at": "2024-03-15T06:46:04.111Z",
    "completed_at": "2024-03-15T06:46:05.490Z"
}
```

{% endtab %}
{% endtabs %}