Endpoint
GET https://requiems.xyz/v1/finance/bin/{bin}
BIN Lookup
Returns card metadata for the given 6–8 digit BIN prefix.
Parameters
| Name |
Type |
Required |
Location |
Description |
bin |
string |
yes |
path |
6–8 digit Bank Identification Number. Dashes and spaces are stripped automatically. |
Response Example
{
"data": {
"bin": "424242",
"scheme": "visa",
"card_type": "credit",
"card_level": "classic",
"issuer_name": "Chase",
"issuer_url": "www.chase.com",
"issuer_phone": "+18002324000",
"country_code": "US",
"country_name": "United States",
"prepaid": false,
"luhn_prefix_valid": true,
"confidence": 0.92
},
"metadata": {
"timestamp": "2026-01-01T00:00:00Z"
}
}
Response Fields
| Field |
Type |
Description |
bin |
string |
The normalised BIN prefix used for the lookup |
scheme |
string |
Card network: visa, mastercard, amex, discover, jcb, diners, unionpay, maestro, mir, rupay, private_label |
card_type |
string |
credit, debit, prepaid, or charge |
card_level |
string |
classic, gold, platinum, infinite, business, signature, or standard |
issuer_name |
string |
Name of the card-issuing bank |
issuer_url |
string |
Bank website URL |
issuer_phone |
string |
Bank customer service phone number |
country_code |
string |
ISO 3166-1 alpha-2 country code of the issuing bank (e.g. US, GB, DE) |
country_name |
string |
Full country name of the issuing bank |
prepaid |
boolean |
Whether the card is a prepaid card |
luhn_prefix_valid |
boolean |
Whether the BIN prefix (not a full card number) passes the Luhn algorithm check |
confidence |
number |
Data quality score (0.00–1.00). Multi-source confirmed records score higher. |
Errors
400 bad_request — BIN is not 6–8 digits or contains non-digit characters.
404 not_found — BIN prefix not found in the database.
500 internal_error — Unexpected server error.
1---
2name: bin-lookup-get-bin
3api: BIN Lookup
4method: GET
5path: /v1/finance/bin/{bin}
6base_url: https://requiems.xyz
7description: Returns card metadata for the given 6–8 digit BIN prefix.
8---
9
10## Endpoint
11
12**GET https://requiems.xyz/v1/finance/bin/{bin}**
13
14## BIN Lookup
15
16Returns card metadata for the given 6–8 digit BIN prefix.
17
18## Parameters
19
20| Name | Type | Required | Location | Description |
21| ---- | ---- | -------- | -------- | ----------- |
22| `bin` | string | yes | path | 6–8 digit Bank Identification Number. Dashes and spaces are stripped automatically. |
23
24## Response Example
25
26```json
27{
28 "data": {
29 "bin": "424242",
30 "scheme": "visa",
31 "card_type": "credit",
32 "card_level": "classic",
33 "issuer_name": "Chase",
34 "issuer_url": "www.chase.com",
35 "issuer_phone": "+18002324000",
36 "country_code": "US",
37 "country_name": "United States",
38 "prepaid": false,
39 "luhn_prefix_valid": true,
40 "confidence": 0.92
41 },
42 "metadata": {
43 "timestamp": "2026-01-01T00:00:00Z"
44 }
45}
46```
47
48## Response Fields
49
50| Field | Type | Description |
51| ----- | ---- | ----------- |
52| `bin` | string | The normalised BIN prefix used for the lookup |
53| `scheme` | string | Card network: visa, mastercard, amex, discover, jcb, diners, unionpay, maestro, mir, rupay, private_label |
54| `card_type` | string | credit, debit, prepaid, or charge |
55| `card_level` | string | classic, gold, platinum, infinite, business, signature, or standard |
56| `issuer_name` | string | Name of the card-issuing bank |
57| `issuer_url` | string | Bank website URL |
58| `issuer_phone` | string | Bank customer service phone number |
59| `country_code` | string | ISO 3166-1 alpha-2 country code of the issuing bank (e.g. US, GB, DE) |
60| `country_name` | string | Full country name of the issuing bank |
61| `prepaid` | boolean | Whether the card is a prepaid card |
62| `luhn_prefix_valid` | boolean | Whether the BIN prefix (not a full card number) passes the Luhn algorithm check |
63| `confidence` | number | Data quality score (0.00–1.00). Multi-source confirmed records score higher. |
64
65## Errors
66
67- `400` **bad_request** — BIN is not 6–8 digits or contains non-digit characters.
68- `404` **not_found** — BIN prefix not found in the database.
69- `500` **internal_error** — Unexpected server error.