{"openapi":"3.1.0","info":{"title":"Card BIN Lookup x402","version":"1.0.0","description":"Instant card BIN intelligence. Bank, brand, country, type, funding & more via x402.","x-guidance":"Pay-per-call card BIN intelligence. POST /v1/bin with {\"bin\": \"448590\"} to resolve the issuing bank, scheme, card type, level and country for a card's first 6-8 digits — useful for routing, fraud screening and checkout risk decisions. POST /v1/verify additionally cross-checks the BIN against an IP, phone, IBAN and address to produce a combined fraud assessment. Every call is priced in USDC and settled over x402 on Base or Solana; no API key or account is needed. Requests may also be sent as GET with query parameters. A failed lookup returns a 4xx or 5xx and is never charged.","contact":{"email":"support@binx402.com"}},"servers":[{"url":"https://binx402.com"}],"paths":{"/v1/bin":{"post":{"operationId":"lookupBin","summary":"BIN lookup - resolve issuer, scheme, type and country for a card BIN","tags":["BIN"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bin":{"type":"string","minLength":6,"description":"The first 6 to 8 digits of a payment card, e.g. \"448590\"."}},"required":["bin"]}}}},"responses":{"200":{"description":"Successful lookup","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the lookup succeeded."},"code":{"type":"integer","description":"Upstream status code."},"BIN":{"type":"object","description":"Card metadata resolved from the BIN.","properties":{"valid":{"type":"boolean"},"number":{"type":"integer","description":"The BIN that was looked up."},"length":{"type":"integer"},"scheme":{"type":"string","description":"Card scheme, e.g. VISA."},"brand":{"type":"string","description":"Card brand."},"type":{"type":"string","description":"CREDIT, DEBIT or CHARGE."},"level":{"type":"string","description":"Product level, e.g. PURCHASING."},"is_commercial":{"type":"string"},"is_prepaid":{"type":"string"},"currency":{"type":"string"},"issuer":{"type":"object","properties":{"name":{"type":"string","description":"Issuing bank."},"website":{"type":"string"},"phone":{"type":"string"}}},"country":{"type":"object","properties":{"name":{"type":"string"},"alpha2":{"type":"string"},"currency":{"type":"string"}}}},"required":["valid","scheme"]}},"required":["success","BIN"]}}}},"400":{"description":"Invalid or missing parameters. Not charged."},"402":{"description":"Payment Required"},"502":{"description":"Upstream provider failed. Not charged."}}}},"/v1/verify":{"post":{"operationId":"verifyIdentity","summary":"Multi-signal verification - assess a BIN together with IP, phone, IBAN and address","tags":["BIN","Fraud"],"x-payment-info":{"price":{"mode":"fixed","currency":"USD","amount":"0.010000"},"protocols":[{"x402":{}}]},"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","properties":{"bin":{"type":"string","minLength":6,"description":"Card BIN. Required."},"ip":{"type":"string","description":"IPv4 or IPv6 address to cross-check against the BIN country."},"phone":{"type":"string","description":"Phone number in E.164 form, e.g. \"+13023309010\"."},"iban":{"type":"string","description":"IBAN to validate."},"country":{"type":"string","description":"ISO 3166-1 alpha-2 country code."},"company":{"type":"string"},"vat":{"type":"string","description":"VAT registration number."},"address":{"type":"string"},"state":{"type":"string"},"postcode":{"type":"string"}},"required":["bin"]}}}},"responses":{"200":{"description":"Successful lookup","content":{"application/json":{"schema":{"type":"object","properties":{"success":{"type":"boolean","description":"Whether the lookup succeeded."},"code":{"type":"integer","description":"Upstream status code."},"BIN":{"type":"object","description":"Card metadata resolved from the BIN.","properties":{"valid":{"type":"boolean"},"number":{"type":"integer","description":"The BIN that was looked up."},"length":{"type":"integer"},"scheme":{"type":"string","description":"Card scheme, e.g. VISA."},"brand":{"type":"string","description":"Card brand."},"type":{"type":"string","description":"CREDIT, DEBIT or CHARGE."},"level":{"type":"string","description":"Product level, e.g. PURCHASING."},"is_commercial":{"type":"string"},"is_prepaid":{"type":"string"},"currency":{"type":"string"},"issuer":{"type":"object","properties":{"name":{"type":"string","description":"Issuing bank."},"website":{"type":"string"},"phone":{"type":"string"}}},"country":{"type":"object","properties":{"name":{"type":"string"},"alpha2":{"type":"string"},"currency":{"type":"string"}}}},"required":["valid","scheme"]},"IP":{"type":"object","description":"Geolocation, network and threat metadata for the address.","properties":{"IP":{"type":"string"},"ip_version":{"type":"integer"},"valid":{"type":"boolean"},"alpha2":{"type":"string","description":"ISO country code."},"country":{"type":"string"},"region":{"type":"string"},"city":{"type":"string"},"latitude":{"type":"number"},"longitude":{"type":"number"},"zip_code":{"type":"string"},"time_zone":{"type":"string"},"is_proxy":{"type":"boolean","description":"True when the address is a known proxy or VPN."},"isp":{"type":"string"},"asn":{"type":"string"},"proxy":{"type":"object","description":"Present when the address is a known proxy.","properties":{"type":{"type":"string"},"isp":{"type":"string"},"domain":{"type":"string"},"country_name":{"type":"string"},"city_name":{"type":"string"}}}},"required":["IP","valid"]},"PHONE":{"type":"object","description":"Phone line metadata when `phone` is supplied."},"IBAN":{"type":"object","description":"Bank account metadata when `iban` is supplied."},"assessment":{"type":"object","description":"Cross-signal fraud assessment combining the supplied identifiers."}},"required":["success"]}}}},"400":{"description":"Invalid or missing parameters. Not charged."},"402":{"description":"Payment Required"},"502":{"description":"Upstream provider failed. Not charged."}}}}}}