Name: iin-lookup
Price: 0.02 USDC
Availability: InStock

$ man iin-lookup

agentutility / locale / iin-lookup

PRICE / CALL

$0.02

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

locale

CATEGORY

uncategorized

STATUS

● live

NAME

iin-lookup — resolves an issuer identification number (the first 6-8 card digits) to scheme, issuer, country, card type, and prepaid/debit/credit sign…

synonym alias of bin-lookup — reuses the canonical handler.

SYNOPSIS

POST https://x402.agentutility.ai/iin-lookup
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Resolves an issuer identification number (the first 6-8 card digits) to scheme, issuer, country, card type, and prepaid/debit/credit signals using binlist.net. Use it as an IIN lookup or card BIN checker.

INPUT — request schema

property	type	description	req?
bin	string	—	required

OUTPUT — response shape

field	type	description
scheme	string	—
type	string	—
country	string	—

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/iin-lookup \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the iin-lookup tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: localeiinlookupiin-lookup
methods: POST
cluster: locale
price: $0.02 USDC per call

ADJACENT — other endpoints in locale

endpoint	description	price
address-geocode	Converts a free-form address, postal code, place name, or POI into latitude/longitude.	$0.02
airport-delays	Reports live US airport delays, ground stops, and closures from the FAA National Airspace System Status feed.	$0.02
bin-lookup	Looks up a credit card BIN: the first 6-8 digits resolve to issuer, country, brand, and card type via binlist.net.	$0.02
bin-lookup-api	Looks up card BINs, resolving the first 6-8 card digits to scheme, issuer, country, card type, prepaid/debit/credit signal, and payment-r…	$0.02
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…	$0.02
geocode	Geocodes addresses and place names to coordinates; exact short alias for address-geocode so agents searching for 'geocode' can discover t…	$0.02
reverse-geocode	Converts latitude/longitude coordinates into a structured street address.	$0.02
satellite-bbox	Builds a cloud-free Sentinel-2 mosaic over any bounding box and returns it as a single PNG composite.	$0.02