# BIN Lookup

**GET** `/dpm/payments-gwproxy/v2/cards/binlookup/{bin}`

Base URL: `https://api.pre.globalgetnet.com`

__BIN Lookup__<br> <br>This endpoint retrieves detailed information about a specific BIN (Bank Identification Number), including brand, country of issue, issuer, and product type. It’s used to identify and classify credit or debit cards before processing.<br> <br>**Usage Scenarios:**<br>_- Identifying the brand or network of a card using its BIN.<br>- Determining the issuing country or financial institution.<br>- Classifying the card type (credit, debit, prepaid, etc.).<br>- Enhancing fraud prevention and analytics by understanding the card’s origin._<br> <br>**Notes:**<br>_- Requires the bin parameter in the path, typically the first 9 digits of a card number.<br>- Useful for card validation, enrichment, and routing logic._

## Authorization

- PROD (oauth2)
- PRE (oauth2)
- SBX (oauth2)

## Path parameters

- `bin` (string, required)
  bin

## Responses

### 200

Request executed successfully

- `results` (object[])
  - `bin` (integer)
    BIN of the query.
  - `brand` (string)
    Flag name.
  - `brand_code` (integer)
    Flag code.
  - `brazilian_issued` (string)
    Informs whether the issuer is from Brazil.
  - `country` (string)
    Country name.
  - `country_code` (string)
    Country numeric code.
  - `country_code_iso` (string)
    ISO_3166-1 country code.
  - `issuer` (string)
    Issuer name.
  - `product` (string)
    Product linked to BIN.
  - `type` ("credit" | "debit" | "prepaid")
    BIN type (credit, debit, prepaid).
- `status` (string)
  BIN Status return message.

Example:

```json
{
  "results": [
    {
      "bin": 0,
      "brand": "string",
      "brand_code": 0,
      "brazilian_issued": "string",
      "country": "string",
      "country_code": "string",
      "country_code_iso": "string",
      "issuer": "string",
      "product": "string",
      "type": "credit"
    }
  ],
  "status": "string"
}
```

### 401

Invalid authentication. Check your credentials or contact the Getnet Relationship Center.

- `status` (string)
  Error situation.
- `error_code` (string)
  Error code.
- `description` (string)
  Description of the error.
- `description_detail` (string)
  Detailed description of the error.
- `brand` (string)
  Brand.
- `payment_id` (string)
  payment_id.
- `seller_id` (string)
  seller_id.
- `amount` (string)
  amount.
- `currency` (string)
  currency.
- `order_id` (string)
  order_id.
- `credit_cancel` (object)
  credit_cancel.
  - `canceled_at` (string)
    canceledAt.
  - `message` (string)
    message.
- `payment_tag` (string)
  payment_tag.
- `status_code` (string)
  statusCode.
- `message` (string)
  message.
- `name` (string)
  name.
- `acquirer_transaction_id` (string)
  acquirer_transaction_id.
- `authorization_code` (string)
  authorization_code.
- `transaction_id` (string)
  transaction_id.
- `reason_code` (string)
  reason_code.
- `reason_message` (string)
  reason_message.
- `merchant_advice_code` (string)
  merchant_advice_code.

Example:

```json
{
  "status": "string",
  "error_code": "string",
  "description": "string",
  "description_detail": "string",
  "brand": "string",
  "payment_id": "string",
  "seller_id": "string",
  "amount": "string",
  "currency": "string",
  "order_id": "string",
  "credit_cancel": {
    "canceled_at": "string",
    "message": "string"
  },
  "payment_tag": "string",
  "status_code": "string",
  "message": "string",
  "name": "string",
  "acquirer_transaction_id": "string",
  "authorization_code": "string",
  "transaction_id": "string",
  "reason_code": "string",
  "reason_message": "string",
  "merchant_advice_code": "string"
}
```

### 404

Not found

- `status` (string)
  Error situation.
- `error_code` (string)
  Error code.
- `description` (string)
  Description of the error.
- `description_detail` (string)
  Detailed description of the error.
- `brand` (string)
  Brand.
- `payment_id` (string)
  payment_id.
- `seller_id` (string)
  seller_id.
- `amount` (string)
  amount.
- `currency` (string)
  currency.
- `order_id` (string)
  order_id.
- `credit_cancel` (object)
  credit_cancel.
  - `canceled_at` (string)
    canceledAt.
  - `message` (string)
    message.
- `payment_tag` (string)
  payment_tag.
- `status_code` (string)
  statusCode.
- `message` (string)
  message.
- `name` (string)
  name.
- `acquirer_transaction_id` (string)
  acquirer_transaction_id.
- `authorization_code` (string)
  authorization_code.
- `transaction_id` (string)
  transaction_id.
- `reason_code` (string)
  reason_code.
- `reason_message` (string)
  reason_message.
- `merchant_advice_code` (string)
  merchant_advice_code.

Example:

```json
{
  "status": "string",
  "error_code": "string",
  "description": "string",
  "description_detail": "string",
  "brand": "string",
  "payment_id": "string",
  "seller_id": "string",
  "amount": "string",
  "currency": "string",
  "order_id": "string",
  "credit_cancel": {
    "canceled_at": "string",
    "message": "string"
  },
  "payment_tag": "string",
  "status_code": "string",
  "message": "string",
  "name": "string",
  "acquirer_transaction_id": "string",
  "authorization_code": "string",
  "transaction_id": "string",
  "reason_code": "string",
  "reason_message": "string",
  "merchant_advice_code": "string"
}
```

### 500

Internal server error. Please try again later.

- `status` (string)
  Error situation.
- `error_code` (string)
  Error code.
- `description` (string)
  Description of the error.
- `description_detail` (string)
  Detailed description of the error.
- `brand` (string)
  Brand.
- `payment_id` (string)
  payment_id.
- `seller_id` (string)
  seller_id.
- `amount` (string)
  amount.
- `currency` (string)
  currency.
- `order_id` (string)
  order_id.
- `credit_cancel` (object)
  credit_cancel.
  - `canceled_at` (string)
    canceledAt.
  - `message` (string)
    message.
- `payment_tag` (string)
  payment_tag.
- `status_code` (string)
  statusCode.
- `message` (string)
  message.
- `name` (string)
  name.
- `acquirer_transaction_id` (string)
  acquirer_transaction_id.
- `authorization_code` (string)
  authorization_code.
- `transaction_id` (string)
  transaction_id.
- `reason_code` (string)
  reason_code.
- `reason_message` (string)
  reason_message.
- `merchant_advice_code` (string)
  merchant_advice_code.

Example:

```json
{
  "status": "string",
  "error_code": "string",
  "description": "string",
  "description_detail": "string",
  "brand": "string",
  "payment_id": "string",
  "seller_id": "string",
  "amount": "string",
  "currency": "string",
  "order_id": "string",
  "credit_cancel": {
    "canceled_at": "string",
    "message": "string"
  },
  "payment_tag": "string",
  "status_code": "string",
  "message": "string",
  "name": "string",
  "acquirer_transaction_id": "string",
  "authorization_code": "string",
  "transaction_id": "string",
  "reason_code": "string",
  "reason_message": "string",
  "merchant_advice_code": "string"
}
```