curl --request POST \
  --url https://api.payos.ai/api/bin/intelligence \
  --header 'X-API-Key: sk_live_your_api_key' \
  --header 'Content-Type: application/json' \
  --data '{
    "bin": "41111111"
  }'

{
  "success": true,
  "inquiryId": "20e791ff-6937-45fc-a28a-f358b7e6a4b1",
  "statusCode": 200,
  "errorCode": null,
  "data": {
    "status": "COMPLETED",
    "submitTimeUtc": "2026-06-18T21:47:57Z",
    "card": {
      "type": "001",
      "brandName": "VISA",
      "currency": "USD",
      "accountBillingCurrency": null,
      "minLength": null,
      "maxLength": "16",
      "credentialType": "PAN",
      "tokenizationSupported": null,
      "brands": [
        { "type": "001", "brandName": "VISA" }
      ]
    },
    "features": {
      "accountFundingSource": "DEBIT",
      "accountFundingSourceSubType": null,
      "cardProduct": "Visa Signature",
      "productCode": null,
      "productType": null,
      "productId": "Q4",
      "productIdSubtype": "BB",
      "cardPlatform": "CONSUMER",
      "comboCard": "0",
      "corporatePurchase": null,
      "healthCard": false,
      "fleetCard": false,
      "exemptBIN": false,
      "autoSubstantiation": false,
      "cashbackEligible": null,
      "cpsOptionEnabled": null,
      "messageType": "D",
      "threeDSSupport": true,
      "siEligible": true,
      "emiEligible": false,
      "atmEnabled": true,
      "posEnabled": true,
      "ecomEnabled": true,
      "flexCredential": false,
      "standInEligible": null,
      "alpEnabled": null,
      "dpwrEnabled": null,
      "rtpEnabled": null,
      "routingNetwork": null,
      "acceptanceLevel": "0",
      "sharedBIN": false,
      "posDomesticOnly": false,
      "gamblingAllowed": true,
      "onlineGamblingBlock": false,
      "commercialCardLevel2": false,
      "commercialCardLevel3": false,
      "regulationII": null,
      "accountLevelManagement": true
    },
    "network": {
      "id": "0001",
      "acceptanceBrand": null,
      "ica": null,
      "oneParticipation": null
    },
    "issuerInformation": {
      "name": "Example Bank National Association",
      "country": "USA",
      "countryName": "UNITED STATES",
      "binLength": "8",
      "accountPrefix": "41111111",
      "binRangeStart": null,
      "binRangeEnd": null,
      "phoneNumber": "+18005551234"
    },
    "payoutInformation": {
      "pushFunds": {
        "domesticParticipant": "true",
        "crossBorderParticipant": "true",
        "moneyTransferDomestic": "Y",
        "moneyTransferCrossBorder": "Y",
        "moneyTransferFastFundsDomestic": "Y",
        "moneyTransferFastFundsCrossBorder": "N",
        "nonMoneyTransferDomestic": "Y",
        "nonMoneyTransferCrossBorder": "N",
        "nonMoneyTransferFastFundsDomestic": "Y",
        "nonMoneyTransferFastFundsCrossBorder": "N",
        "onlineGamblingDomestic": "Y",
        "onlineGamblingCrossBorder": "N",
        "onlineGamblingFastFundsDomestic": "Y",
        "onlineGamblingFastFundsCrossBorder": "N"
      },
      "pullFunds": {
        "domesticParticipant": "true",
        "crossBorderParticipant": "false",
        "geoRestrictionIndicator": "Y"
      }
    }
  }
}

{
  "success": true,
  "inquiryId": "9b2c1d44-1f0e-4a77-8c21-72d5b0c91a3e",
  "statusCode": 200,
  "errorCode": null,
  "data": {
    "status": "MULTIPLE",
    "submitTimeUtc": "2026-06-18T21:48:10Z",
    "card": {
      "brandName": "VISA",
      "credentialType": "PAN"
    }
  }
}

{
  "success": true,
  "inquiryId": "c3a0f9e2-6b54-4d1e-9f88-2a6f1e0b7d44",
  "statusCode": 200,
  "errorCode": null,
  "data": {
    "status": "NO_MATCH",
    "submitTimeUtc": "2026-06-18T21:48:22Z"
  }
}

{
  "success": false,
  "inquiryId": "20e791ff-6937-45fc-a28a-f358b7e6a4b1",
  "statusCode": 207,
  "errorCode": "PARTIAL_FAILURE",
  "error": "One or more failures occurred while processing the request. Please contact the PayOS team for assistance.",
  "data": {
    "status": "COMPLETED",
    "submitTimeUtc": "2026-06-18T21:47:57Z",
    "card": {
      "type": "001",
      "brandName": "VISA",
      "currency": "USD",
      "accountBillingCurrency": null,
      "minLength": null,
      "maxLength": "16",
      "credentialType": "PAN",
      "tokenizationSupported": null,
      "brands": [
        { "type": "001", "brandName": "VISA" }
      ]
    },
    "issuerInformation": {
      "name": "Example Bank National Association",
      "country": "USA",
      "countryName": "UNITED STATES",
      "binLength": "8",
      "accountPrefix": "41111111",
      "binRangeStart": null,
      "binRangeEnd": null,
      "phoneNumber": "+18005551234"
    }
  }
}

{
  "success": false,
  "error": "Either bin or accountNumber is required, but not both."
}

{
  "success": false,
  "error": "Character invalidation. Do you have any of these characters in your request: \\ ^ , \" ( ) | ; ~"
}

{
  "error": {
    "code": "UNAUTHORIZED",
    "ruleCode": 9001,
    "message": "Invalid API key"
  }
}

{
  "error": {
    "code": "FORBIDDEN",
    "ruleCode": 9005,
    "message": "API key is not authorized for this resource"
  }
}

{
  "success": false,
  "error": "An upstream error occurred while processing the request.",
  "inquiryId": "20e791ff-6937-45fc-a28a-f358b7e6a4b1"
}