Card issuer from BIN API

Identifies the payment network (Visa, Mastercard, Amex, Discover, Diners, JCB, UnionPay) from a card BIN/prefix and checks length validity for that network. Answers 'Which network is this card?', 'Is the length valid for it?'.

Price$0.02per request

MethodPOST

Route/v1/validate/card-bin

StatusLive

MIME typeapplication/json

Rate limit120/minute

Cache0s public

cardbiniinissuernetworkvalidatepaymentsvisamastercard

API URLhttps://x402.hexl.dev/v1/validate/card-bin

Integration docs

Example request

{
  "number": "4111111111111111"
}

Example response

{
  "valid": true,
  "reason": "BIN matches Visa; length 16 is valid for Visa.",
  "bin": "411111",
  "network": "Visa",
  "length": 16,
  "expectedLengths": [
    13,
    16,
    19
  ],
  "lengthValid": true
}

Input schema

{
  "type": "object",
  "required": [
    "number"
  ],
  "properties": {
    "number": {
      "type": "string",
      "description": "Card number or 6-19 digit BIN/prefix.",
      "examples": [
        "4111111111111111"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}