Card Bin Lookup

Resolves the first 6-8 digits of a card number to issuer bank, country, brand (Visa/Mastercard/Amex/Discover/JCB/UnionPay), and card type (debit/credit/prepaid).

Overview

Resolves the first 6-8 digits of a card number to issuer bank, country, brand (Visa/Mastercard/Amex/Discover/JCB/UnionPay), and card type (debit/credit/prepaid). Use it as a credit card BIN lookup, IIN lookup, or card-issuer lookup for fraud screening, payment routing, and geo-risk.

Endpoint

Method	Endpoint	Price	Description
POST	/v1/marketplace/api/card-bin-lookup	$0.023	Invoke Card Bin Lookup (Geo) and return the upstream response.

How to call it

Requests are paid per call over the x402 protocol. Call the endpoint, receive a 402 Payment Required quote, then repeat the request with the signed payment header. The SDKs do both steps for you.

# 1. Ask for a quote
curl -i -X POST https://api.jarvisclaw.ai/v1/marketplace/api/card-bin-lookup \
  -H 'Content-Type: application/json' \
  -d '{}'

# 2. Pay it (the SDK signs and retries for you)
curl -X POST https://api.jarvisclaw.ai/v1/marketplace/api/card-bin-lookup \
  -H 'Content-Type: application/json' \
  -H 'X-PAYMENT: <signed-payload>' \
  -d '{}'

Open in the marketplace