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