BIN Lookup
Pricing
$2.00 / 1,000 requests
BIN Lookup
Lookup/validate any Bank Identification Numbers (BINs) and retrieve comprehensive card information including scheme, bank details, and country information. Ideal for payment processing, fraud detection, and card validation.
Pricing
$2.00 / 1,000 requests
Rating
0.0
(0)
Developer
Greip
Maintained by CommunityActor stats
0
Bookmarked
40
Total users
0
Monthly active users
5 days ago
Last modified
Categories
Features
Share
Greip BIN/IIN Lookup
An Apify Actor that looks up Bank Identification Numbers (BIN) and Issuer Identification Numbers (IIN) using the Greip BIN Lookup API v2 (https://v2.greipapi.com). It returns card scheme, issuing bank, country, and validation metadata for payment and fraud workflows.
Features
- Card validation: BIN/IIN validation via Greip v2
- Scheme and bank metadata: Card type, brand, issuer, and geography
- Blacklist signal:
isBlacklistedwhen Greip reports a blacklisted BIN - Test mode: Optional
mode=testfor deterministic fake data without quota use - Privacy-aware logging: Card numbers are masked in logs; full dataset fields are not logged
- Safe dataset BIN: Output and API lookup use at most 8 leading numeric digits only (never a full card number or masked tail)
Input parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
bin | string | Yes | - | 6-8 digit BIN or masked card (see below) |
mode | string | No | live | live (production) or test (fake data, no quota) |
Configure GREIP_API_KEY as an Actor environment variable (Apify Console secrets or local shell export). v2 uses Authorization: Bearer only (no key query parameter). Do not put the API key in run input or INPUT.json.
API endpoint
GET https://v2.greipapi.com/lookup/bin/{bin}?source=Apify
Optional query: mode=test when input mode is test.
Output format
Example dataset item (v2-mapped camelCase fields):
{"bin": "517041","reason": "accept","isValid": true,"schemeName": "Mastercard","schemeCoName": null,"isLuhn": true,"isPrepaid": false,"isCommercial": false,"schemeType": "debit","schemeBrand": "STANDARD","currency": "USD","isBlacklisted": false,"detectedDigits": "5","syntaxGaps": [4, 8, 12],"syntaxLengths": [16],"syntaxCodeName": "CVV","syntaxCodeSize": 3,"bankId": null,"bankIdentifier": "EXAMPLE_BANK","bankName": "Example Bank","bankCity": "New York","bankUrl": "https://examplebank.com","bankPhone": null,"bankLogo": null,"bankLatitude": null,"bankLongitude": null,"countryAlpha2": "US","countryName": "United States","countryCode": "+1","countryNumeric": "840","countryEmoji": "🇺🇸","countryContinent": "North America","countryLanguageCode": "en","countryLanguageNative": "English","timestamp": "2026-11-15T12:00:00.000Z"}
Field notes (v1 to v2)
| Output key | v1 source | v2 source |
|---|---|---|
isValid | data.isValid | data.is_valid |
isLuhn | data.info.scheme.isLuha | data.scheme.is_luhn |
isPrepaid | data.info.scheme.isPrepaid | data.scheme.is_prepaid |
isCommercial | data.info.scheme.isCommercial | data.scheme.is_commercial |
schemeCoName | data.info.scheme.coName | always null (no v2 field) |
reason | data.reason | data.reason if present, else null |
detectedDigits | data.info.detected_digits | data.detected_digits |
countryLanguageCode | data.info.country.languageCode | data.country.language_code |
countryLanguageNative | data.info.country.languageNative | data.country.language_native |
isBlacklisted | n/a | data.is_blacklisted |
bin | input echoed | leading digits of data.bin or input (max 8) |
| Other flattened keys | under data.info.* | directly under data.* (same logical names) |
Output field descriptions
bin: Up to 8 leading numeric digits from Greipdata.binor from the start of input (stops at the first non-digit). Full or masked card strings are never stored.schemeCoName: Reserved for compatibility; v2 does not return this value (alwaysnull).reason(recommendation): Greip validation recommendation as a string when present. Documented values:accept,review,reject. Non-string or missing values outputnull.isLuhn: Greip v2scheme.is_luhn.truewhen the card number passes Luhn (mod 10) validation,falsewhen it fails,nullwhen Greip omits the field.isBlacklisted: Greip v2is_blacklisted.truewhen the BIN is on the Greip blacklist,falsewhen it is not,nullwhen Greip omits the field.- Booleans: When Greip omits a boolean field, the Actor outputs
null(v1 often coerced tofalse).syntaxGapsandsyntaxLengthsstill default to[]when syntax is missing.
Supported BIN formats
517041(6-digit BIN, recommended)45678912(8-digit BIN)4567891234(10-11 digit BIN prefix)456789XXXXXX1234(masked card)
Do not send full card numbers. Use a 6-8 digit BIN or a masked format only.
Local development
npm installnpm run buildnpm run lintnpm test
Set GREIP_API_KEY in your shell environment, then run with Apify local storage for run input (bin, optional mode only):
export GREIP_API_KEY=your_keyapify run# ornpm run start:dev
Use mode: "test" in run input to call Greip with mode=test (deterministic fake data, no quota) while still authenticating with your environment API key.
Feedback
Technical feedback or bugs: Greip BIN Lookup issues on Apify.