{"uid":"cap_WzQrxQFyrG3JbJsOGnRDn","slug":"card-bin-lookup-x402-ab18e289","name":"Card BIN Lookup x402","description":"Instant card BIN intelligence. Bank, brand, country, type, funding & more via x402.","url":"https://binx402.com/v1/verify","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["bin"],"properties":{"ip":{"type":"string","description":"IPv4 or IPv6 address to cross-check against the BIN country."},"bin":{"type":"string","minLength":6,"description":"Card BIN. Required."},"vat":{"type":"string","description":"VAT registration number."},"iban":{"type":"string","description":"IBAN to validate."},"phone":{"type":"string","description":"Phone number in E.164 form, e.g. \"+13023309010\"."},"state":{"type":"string"},"address":{"type":"string"},"company":{"type":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code."},"postcode":{"type":"string"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","required":["success"],"properties":{"IP":{"type":"object","required":["IP","valid"],"properties":{"IP":{"type":"string"},"asn":{"type":"string"},"isp":{"type":"string"},"city":{"type":"string"},"proxy":{"type":"object","properties":{"isp":{"type":"string"},"type":{"type":"string"},"domain":{"type":"string"},"city_name":{"type":"string"},"country_name":{"type":"string"}},"description":"Present when the address is a known proxy."},"valid":{"type":"boolean"},"alpha2":{"type":"string","description":"ISO country code."},"region":{"type":"string"},"country":{"type":"string"},"is_proxy":{"type":"boolean","description":"True when the address is a known proxy or VPN."},"latitude":{"type":"number"},"zip_code":{"type":"string"},"longitude":{"type":"number"},"time_zone":{"type":"string"},"ip_version":{"type":"integer"}},"description":"Geolocation, network and threat metadata for the address."},"BIN":{"type":"object","required":["valid","scheme"],"properties":{"type":{"type":"string","description":"CREDIT, DEBIT or CHARGE."},"brand":{"type":"string","description":"Card brand."},"level":{"type":"string","description":"Product level, e.g. PURCHASING."},"valid":{"type":"boolean"},"issuer":{"type":"object","properties":{"name":{"type":"string","description":"Issuing bank."},"phone":{"type":"string"},"website":{"type":"string"}}},"length":{"type":"integer"},"number":{"type":"integer","description":"The BIN that was looked up."},"scheme":{"type":"string","description":"Card scheme, e.g. VISA."},"country":{"type":"object","properties":{"name":{"type":"string"},"alpha2":{"type":"string"},"currency":{"type":"string"}}},"currency":{"type":"string"},"is_prepaid":{"type":"string"},"is_commercial":{"type":"string"}},"description":"Card metadata resolved from the BIN."},"IBAN":{"type":"object","description":"Bank account metadata when `iban` is supplied."},"code":{"type":"integer","description":"Upstream status code."},"PHONE":{"type":"object","description":"Phone line metadata when `phone` is supplied."},"success":{"type":"boolean","description":"Whether the lookup succeeded."},"assessment":{"type":"object","description":"Cross-signal fraud assessment combining the supplied identifiers."}}}}}}},"responseSchema":{"type":"json","example":{"IP":{"IP":"2.56.188.79","valid":true,"country":"United States of America","is_proxy":true},"BIN":{"type":"CREDIT","valid":true,"scheme":"VISA","currency":"USD"},"code":200,"success":true,"assessment":{"IP_BIN_match":true}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_p1S2lYgB7WwrFzfNUEW7D","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a card BIN (Bank Identification Number) to issuer, scheme, type, country, currency, and optional IP/VAT/IBAN cross-checks","exampleAgentPrompt":"Can you look up the BIN 414720 and tell me which bank issued it, what scheme and card type it is, what country it's from, and whether it matches the IP address 2.56.188.79?","exampleUseCases":[{"title":"Fraud check on mismatched card origin","prompt":"A customer just submitted a payment with card BIN 453998 but their IP is 91.108.4.1 — can you check if the card's country matches that IP and whether the IP looks like a proxy?"},{"title":"Enrich checkout with card type info","prompt":"Before we process this order, look up BIN 520082 and tell me if it's a credit or debit card, which scheme it belongs to, and what currency it's issued in."},{"title":"Verify card BIN validity for onboarding","prompt":"We're onboarding a new merchant and they gave us card BIN 676130 — can you verify if it's a valid BIN and tell us the issuing bank, card type, and country of origin?"}],"resultDescription":"Returns a JSON object with BIN validity, card scheme (e.g. VISA, MASTERCARD), card type (CREDIT/DEBIT/PREPAID), issuing bank, currency, and country of issuance. Optionally includes IP geolocation details (city, country, ASN, ISP, proxy/VPN flag, latitude/longitude, timezone) and an assessment of whether the IP country matches the BIN country.","failureModes":["BIN shorter than 6 digits returns a validation error","Unknown or unregistered BIN returns valid=false","Invalid IP format causes IP enrichment to fail or be skipped","Malformed VAT/IBAN inputs return validation failures for those fields","Service unavailable or payment failure returns HTTP 402/503"],"whenToPreferThis":"Choose this endpoint when you need real-time card BIN intelligence paid per-call with no subscription, especially when you also want optional IP geolocation cross-checking, proxy detection, and VAT/IBAN validation bundled in a single request. It is ideal for fraud detection pipelines, checkout enrichment, and compliance checks where BIN data must be correlated with customer location signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T18:31:21.424Z","isFirstParty":false}