apyhub
โ–ฃ DATA VALIDATION ยท FINANCE

BIN IP Checker API

What it does

BIN IP Checker lets you send a BIN and an IP address, then returns a simple response envelope with a numeric code and a success flag. Use it when you need to check card issuer information against an IP-based signal in your backend flow.

The request is straightforward: pass bin and ip as query parameters. The response schema is minimal, so you should expect the standard envelope fields and any additional module blocks returned by the service. That makes it easy to integrate into risk checks, checkout validation, or fraud-routing logic without parsing a large payload.

Because the output is lightweight, this service fits well into real-time decisioning. For example, you can call BIN IP Checker during payment initiation to gate suspicious combinations before you move to authorisation, or use it in a rules engine alongside other identity and transaction checks.

If you just need a quick yes/no-style result with a code for handling, BIN IP Checker keeps the contract simple.

GET
BIN/IP Checker
https://api.eu.apyhub.com/quadlem/bin-ip-checker

QUICKSTART

GUIDE

Quickstart

Use the following request to analyze a payment card BIN and compare it with an IP address to detect potential country mismatches and fraud indicators.

curl -X GET "https://api.eu.apyhub.com/quadlem/bin-ip-checker?bin=123456&ip=8.8.8.8" \
  -H "apy-token: $APY_TOKEN"

What you'll get back

A successful request returns details about the payment card BIN, IP address intelligence, and whether the issuing country of the card matches the IP address location.

{
  "success": true,
  "code": 200,
  "BIN": {
    "valid": true,
    "number": 123456,
    "scheme": "EXAMPLE BRAND",
    "type": "CREDIT",
    "currency": "NIO",
    "country": {
      "name": "NICARAGUA",
      "alpha2": "NI",
      "flag": "๐Ÿ‡ณ๐Ÿ‡ฎ"
    }
  },
  "IP": {
    "IP": "8.8.8.8",
    "country": "United States of America",
    "is_proxy": false,
    "is_vpn": false,
    "IP_BIN_match": false,
    "IP_BIN_match_message": "The IP address country doesn't match the country of the BIN",
    "risk_score": 0,
    "risk_level": "low",
    "recommendation": "accept"
  }
}

Note: When both bin and ip are provided, the response includes cross-validation signals such as IP_BIN_match and IP_BIN_match_message to help identify geographic inconsistencies that may indicate potential fraud.

TRY ITLIVE ยท 40 ATOMS
Loading your default keyโ€ฆ
The full key is used to call the gateway and stays in this tab โ€” never sent to orbit or saved.

About this endpoint

What it does

Checks a card's BIN against an IP address to verify whether the card's issuer country matches the IP's geolocated country โ€” a common signal for cross-border fraud detection.

Query Parameter(s)

AttributeTypeMandatoryDescription
binStringYesBIN to check.
ipStringYesIP address to check.

Response

AttributeTypeDescription
successBooleanWhether the request succeeded.
codeIntegerNumeric response code.
BINObjectCard issuer identification โ€” scheme, brand, type, level, issuer, country.
IPObjectIP geolocation, ISP/ASN, proxy/VPN/Tor flags, and fraud risk.
IP.IP_BIN_matchBooleanWhether the IP's country matches the BIN's issuer country.
IP.IP_BIN_match_messageStringExplanation of the match/mismatch.

Query parameters

Name
Type
Description
ipREQUIRED
string
โ€”
binREQUIRED
string
โ€”
โ–ฃ COMMON ERRORS

Errors any endpoint can return

400bad_request

Required parameter missing or malformed body.

401unauthorized

API key missing, revoked, or not authorized for this service.

429rate_limited

Your plan's per-second rate exceeded. Retry with exponential backoff.

503upstream_busy

Backend temporarily unavailable. Try again in a few seconds.