Get Payment Source check results

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…

Overview

Use this method to retrieve the latest payment source check results performed for a given applicant action.

During this check, the payment source provided by the applicant — such as a bank card, bank statement, e-wallet, or crypto wallet — is analyzed: its details are extracted, risk is scored, and the resulting verdict is returned.

Request example

curl -X GET \
     'https://api.sumsub.com/resources/api/applicantActions/69fc75a8dd66c3773c000000/checks/latest?type=PAYMENT_SOURCE' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>'

Response explained

The response represents a singleton list of checks containing the latest payment source verification result performed for the given applicant action.

📘

Note

All attributes below are nullable.

Root variables

FieldTypeDescription
answerStringPayment source check answer:
  • GREEN — no risks found.
  • RED — risks found.
checkTypeStringIndicates this is a PAYMENT_SOURCE type of check.
createdAtDateDate and time of the latest payment source check result (for example, 2026-05-07 11:21:13).
idStringUnique identifier of the check.
paymentSourceCheckInfoObjectPayment source check data

paymentSourceCheckInfo attributes

FieldTypeDescription
extractedInfoObjectInformation extracted from the payment source provided by the applicant.
riskCheckObjectRisk assessment results of the payment source.

extractedInfo attributes

FieldTypeDescription
typeStringPayment source type.

Possible values: bankCard, bankStatement, eWallet, cryptoWallet.
institutionNameStringName of the institution that issued the payment method (for example, revolut, binance pay, skrill).
institutionNameEnObjectInstitution name transliterated into English.

Includes only the value string, which contains the English (transliterated) version of the original value.
fullNameStringName of the payment method owner.
fullNameEnObjectPayment method owner name transliterated into English.

Includes only the value string, which contains the English (transliterated) version of the original value.
countryStringThree-letter country code (ISO 3166-1 alpha-3) associated with the payment method.
accountIdentifierStringBank account number, e-wallet identifier, or bank card number associated with the payment method.
ibanStringInternational Bank Account Number (IBAN) associated with the payment method.
nationalBankAccountNumberStringNational bank account number associated with the payment method.
nationalBankCodeStringNational bank code (for example, BLZ, sort code, routing number) associated with the payment method.
emailStringEmail address associated with the payment method.
phoneStringPhone number associated with the payment method.
issuedDateDateDate when the payment method was issued.
validUntilDateDate until which the payment method is valid.
currencyCodeStringThree-letter currency code (ISO 4217) associated with the payment method.
cryptoChainStringBlockchain network used by the crypto wallet (for example, eth, btc).
memoStringMemo or tag associated with the crypto wallet (used by some cryptocurrencies).

riskCheck attributes

FieldTypeDescription
typeStringPayment source type being assessed. Possible values: bankCard, bankStatement, eWallet, cryptoWallet.
answerStringRisk check result for the payment source. Possible values:
  • GREEN — no risks found.
  • YELLOW — minor risks found.
  • RED — high risks found.
bankCardCheckInfoObjectBank card risk assessment details.

Returned when type is bankCard.
cryptoWalletCheckInfoObjectCryptocurrency wallet risk assessment details.

Returned when type is cryptoWallet.
txnPresenceCheckInfoObjectTransaction presence verification details, including evidence image identifiers and the verification outcome.

bankCardCheckInfo attributes

FieldTypeDescription
answerStringBank card risk check result. Possible values:
  • GREEN — no risks found.
  • YELLOW — minor risks found.
  • RED — high risks found.
  • ERROR — check failed.
  • IGNORED — check skipped.
unexpiredStringCard expiration check result. Possible values:
  • GREEN — the card is not expired.
  • RED — the card is expired.
inputDataObjectCard data submitted for the check (card number and expiration date).
riskScoreInfoObjectDetailed risk scores and sub-check results for the bank card.

bankCardCheckInfo.inputData attributes

FieldTypeDescription
numberStringBank card number submitted for the check (typically masked).
validUntilDateCard expiration date submitted for the check.

bankCardCheckInfo.riskScoreInfo attributes

FieldTypeDescription
riskScoreNumberOverall risk score for the bank card in the range 0–1. Higher means riskier.
ipRiskScoreNumberRisk score associated with the IP address that was used during the transaction (0–1).
crossCheckStringCross-verification result combining all bank card sub-checks. Possible values: GREEN, YELLOW, RED, ERROR, IGNORED.
nameMatchStringIndicates whether the cardholder name matches the applicant data. Possible values: GREEN, YELLOW, RED, ERROR, IGNORED.
countryMatchStringIndicates whether the card issuer country matches the applicant country. Possible values: GREEN, YELLOW, RED, ERROR, IGNORED.
highRiskEmailCheckStringIndicates whether the cardholder email is considered high risk. Possible values: GREEN, YELLOW, RED, ERROR, IGNORED.
isFreeEmailBooleantrue if the cardholder email is from a free provider; false otherwise.
unexpiredStringCard expiration check result. Possible values:
  • GREEN — the card is not expired.
  • RED — the card is expired.
countryIpMatchStringIndicates whether the card issuer country matches the IP geolocation country. Possible values: GREEN, YELLOW, RED, ERROR, IGNORED.
ipCountryStringCountry code (ISO 3166-1 alpha-3) derived from the IP geolocation.
emailFirstSeenAtDateDate and time the cardholder email was first observed.
binInfoObjectBIN (Bank Identification Number) lookup details for the bank card.

bankCardCheckInfo.riskScoreInfo.binInfo attributes

FieldTypeDescription
binStringBank Identification Number (the first 6 digits of the card).
brandStringCard brand (for example, Visa, Mastercard, American Express).
issuerStringName of the bank that issued the card.
typeStringCard type (for example, credit, debit).
categoryStringCard category (for example, classic, gold, platinum).
countryStringCountry of the card issuer (ISO 3166-1 alpha-3).
bankUrlStringWebsite URL of the issuing bank.
latNumberLatitude of the issuing bank.
lonNumberLongitude of the issuing bank.
virtualBooleantrue if the card is a virtual card.
prepaidBooleantrue if the card is prepaid.
commercialBooleantrue if the card is a commercial (business) card.

cryptoWalletCheckInfo attributes

For details of the nested provider-specific structures (crystalMonitorData, chainalysisMonitorData, ellipticMonitorData, trmLabsMonitorData, merkleMonitorData).

See the cryptoTxnInfo attributes section in the Get transaction information by txnId reference.

FieldTypeDescription
crystalMonitorDataObjectRisk data from Crystal, including the counterparty entity, signals, and a roll-up answer. Returned when sourceType is crystal.
chainalysisMonitorDataObjectRisk data from Chainalysis (entity/address alert and exposures). Returned when sourceType is chainalysis.
ellipticMonitorDataObjectRisk data from Elliptic: wallet-exposure analysis and transfer screening. Returned when sourceType is elliptic.
trmLabsMonitorDataObjectRisk data from TRM Labs: wallet screening and transfer screening. Returned when sourceType is trmLabs.
merkleMonitorDataObjectRisk data from Merkle Science: wallet screening and transfer screening. Returned when sourceType is merkle.
explorerInfoObjectBlockchain explorer information for the wallet address.

txnPresenceCheckInfo attributes

FieldTypeDescription
imageIdsArray of integersIdentifiers of the evidence images submitted for the transaction-presence check (for example, screenshots of the transaction).
answerStringTransaction-presence verification result. Possible values:
  • GREEN — transaction confirmed.
  • YELLOW — inconclusive.
  • RED — transaction not confirmed.
  • ERROR — check failed.
  • IGNORED — check skipped.

Response examples

If the request is successfully sent and processed, you will get a response like the following:

{
  "checks": [
    {
      "answer": "RED",
      "checkType": "PAYMENT_SOURCE",
      "createdAt": "2026-05-07 11:21:13",
      "id": "53c81f45-7b28-4cb5-9c63-f3ff12d00000",
      "paymentSourceCheckInfo": {
        "riskCheck": {
          "type": "cryptoWallet",
          "answer": "RED",
          "cryptoWalletCheckInfo": {
            "crystalMonitorData": {
              "answer": "RED",
              "blockchains": [
                "eth"
              ],
              "counterparty": {
                "address": null,
                "entity": {
                  "globalId": 90903,
                  "grade": null,
                  "nTx": null,
                  "name": "Bybit Thief 2025",
                  "slug": "Bybit-Thief-2025",
                  "subtype": null,
                  "type": "stolen_coins",
                  "country": null,
                  "currencyBasic": null,
                  "currency": null
                },
                "blocklist": false,
                "received": 436013393641,
                "sent": 410659552191,
                "riskScore": 1,
                "signals": {
                  "received": {
                    "atm": 0,
                    "dark_market": 0,
                    "child_exploitation": 0,
                    "dark_service": 0,
                    "exchange_licensed": 0,
                    "exchange_unlicensed": 0,
                    "p2p_exchange_licensed": 0,
                    "p2p_exchange_unlicensed": 0,
                    "enforcement_action": 0,
                    "exchange_fraudulent": 0,
                    "gambling": 0,
                    "illegal_service": 0,
                    "marketplace": 0,
                    "miner": 0,
                    "mixer": 0,
                    "payment": 0,
                    "ransom": 0,
                    "scam": 0,
                    "stolen_coins": 1,
                    "wallet": 0,
                    "terrorism_financing": 0,
                    "liquidity_pools": 0,
                    "sanctions": 0,
                    "seized_assets": 0,
                    "other": 0,
                    "exchange_mlrisk_high": null,
                    "exchange_mlrisk_low": null,
                    "exchange_mlrisk_moderate": null,
                    "exchange_mlrisk_veryhigh": null,
                    "exchange": null,
                    "trusted_exchange": null,
                    "p2p_exchange_mlrisk_high": null,
                    "p2p_exchange_mlrisk_low": null
                  },
                  "sent": {
                    "atm": 0,
                    "dark_market": 0,
                    "child_exploitation": 0,
                    "dark_service": 0,
                    "exchange_licensed": 0,
                    "exchange_unlicensed": 0,
                    "p2p_exchange_licensed": 0,
                    "p2p_exchange_unlicensed": 0,
                    "enforcement_action": 0,
                    "exchange_fraudulent": 0,
                    "gambling": 0,
                    "illegal_service": 0,
                    "marketplace": 0,
                    "miner": 0,
                    "mixer": 0,
                    "payment": 0,
                    "ransom": 0,
                    "scam": 0,
                    "stolen_coins": 1,
                    "wallet": 0,
                    "terrorism_financing": 0,
                    "liquidity_pools": 0,
                    "sanctions": 0,
                    "seized_assets": 0,
                    "other": 0,
                    "exchange_mlrisk_high": null,
                    "exchange_mlrisk_low": null,
                    "exchange_mlrisk_moderate": null,
                    "exchange_mlrisk_veryhigh": null,
                    "exchange": null,
                    "trusted_exchange": null,
                    "p2p_exchange_mlrisk_high": null,
                    "p2p_exchange_mlrisk_low": null
                  }
                },
                "tags": null,
                "type": "entity"
              },
              "assetSupported": true
            }
          }
        }
      }
    }
  ]
}

If no Payment Source check has been performed, an empty checks array is returned.

{
  "checks": []
}

If the request fails, you will receive an HTTP response containing an error code along with a message explaining the error. For example:

{
  "code": 400,
  "correlationId": "e4491e56d5f23c319b4f901e0c8e4eb6",
  "description": "Invalid id '123456789'"
}

Path Params
string
required
Response
200
Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here!