# BIN lookup service API

This is an API reference for the BIN lookup service.

Version: 1.0.0

## Servers

Production environment
```
https://api-services.pxp.io/api/v1
```

Sandbox environment
```
https://api-services.test.pxp.io/api/v1
```

## Security

### PXP-HMAC

HMAC-based authentication using SHA256. The Authorization header must contain the authentication scheme (PXP-UST1), your tokenId, timestamp, and HMAC signature in the format: `PXP-UST1 {tokenId}:{timestamp}:{hmac}`. Additional headers required: `X-Request-Id` (unique UUID for each request) and `X-Client-Id` (your client identifier).

Type: http
Scheme: PXP-UST1

## Download OpenAPI description

[BIN lookup service API](https://developer.pxp.io/_bundle/apis/bin-lookup.yaml)

## Other

### BIN lookup

 - [POST /bin-recognition/bin-range-lookup](https://developer.pxp.io/apis/bin-lookup/other/bin-lookup.md): Perform a BIN (Bank Identification Number) lookup using a card's PAN (Primary Account Number). This will return high-level data about the card, such as the issuer, card type, and funding source. For more details, use the extended endpoint.

### BIN lookup (extended)

 - [POST /bin-recognition/bin-range-lookup/extended](https://developer.pxp.io/apis/bin-lookup/other/bin-lookup-extended.md): Perform an extended BIN (Bank Identification Number) lookup using a card's PAN (Primary Account Number). This will return detailed information about the card, including the issuer, card type, and funding source. For high-level data, use the standard endpoint.