apyhub
Back
▣ 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

Returns a JSON object holding the card issuer details under BIN, the IP intelligence under IP, and a cross-check of whether the two countries agree.

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.
▣ 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.

Similar APIs

Closest matches in the catalog based on this service.

CALLBIN Lookup APIQuadlem, LLCCALLSearch & Filter BIN Database APIQuadlem, LLCCALLIP Address Lookup APIQuadlem, LLCCALLAddress Validation & Location Lookup APIQuadlem, LLC

From the blog

Reads that touch this API.

The API Sprawl Problem in Ecommerce: How Teams Lose Time to Utility CodeAug 5, 2026Email Validation API: How It Works + 7 Options ComparedSep 24, 2026Data Validation APIs: What Your Checks Actually ProveSep 8, 2026Advanced Email Validation using ApyHub’s API in NodeJSJul 9, 2026