BIN Lookup avatar

BIN Lookup

Pricing

$2.00 / 1,000 requests

Go to Apify Store
BIN Lookup

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

Greip

Maintained by Community

Actor stats

0

Bookmarked

40

Total users

0

Monthly active users

5 days ago

Last modified

Features

Limited permissions

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: isBlacklisted when Greip reports a blacklisted BIN
  • Test mode: Optional mode=test for 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

ParameterTypeRequiredDefaultDescription
binstringYes-6-8 digit BIN or masked card (see below)
modestringNolivelive (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 keyv1 sourcev2 source
isValiddata.isValiddata.is_valid
isLuhndata.info.scheme.isLuhadata.scheme.is_luhn
isPrepaiddata.info.scheme.isPrepaiddata.scheme.is_prepaid
isCommercialdata.info.scheme.isCommercialdata.scheme.is_commercial
schemeCoNamedata.info.scheme.coNamealways null (no v2 field)
reasondata.reasondata.reason if present, else null
detectedDigitsdata.info.detected_digitsdata.detected_digits
countryLanguageCodedata.info.country.languageCodedata.country.language_code
countryLanguageNativedata.info.country.languageNativedata.country.language_native
isBlacklistedn/adata.is_blacklisted
bininput echoedleading digits of data.bin or input (max 8)
Other flattened keysunder data.info.*directly under data.* (same logical names)

Output field descriptions

  • bin: Up to 8 leading numeric digits from Greip data.bin or 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 (always null).
  • reason (recommendation): Greip validation recommendation as a string when present. Documented values: accept, review, reject. Non-string or missing values output null.
  • isLuhn: Greip v2 scheme.is_luhn. true when the card number passes Luhn (mod 10) validation, false when it fails, null when Greip omits the field.
  • isBlacklisted: Greip v2 is_blacklisted. true when the BIN is on the Greip blacklist, false when it is not, null when Greip omits the field.
  • Booleans: When Greip omits a boolean field, the Actor outputs null (v1 often coerced to false). syntaxGaps and syntaxLengths still 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 install
npm run build
npm run lint
npm 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_key
apify run
# or
npm 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.