---
title: "VTS Token Inquiry"
method: POST
path: "/pws/pws_vts_token_inquiry"
tags: ["VTS - PTY To Visa"]
---

# VTS Token Inquiry

`POST /pws/pws_vts_token_inquiry`

## Request

- Base URL: `https://api.uat.paymentology.com/ppws/api`
- URL: `https://api.uat.paymentology.com/ppws/api/pws/pws_vts_token_inquiry`
- Auth: none declared

VTS Token Inquiry

## Request body

- VtsTokenInquiryInternal
  - `api_call_unique_identifier` string, required: Unique number that must be passed at each API request. Identifier to make each API request unique
  - `client_id` integer, required: Unique identifier for the client which Paymentology will provide at outset
  - `token` integer, required: Public token.
  - `tokenReferenceID` string, required: Token Reference ID
  - `tokenRequestorId` string, required: Token Requestor ID
  - `user_id` string: User Id of the Customer who triggered the API request.
  - `remarks` string: Remarks for API request
  - `cardHolderVerificationRetrieve` boolean: Retrieve card Holder Verification
  - `deviceBindingInfo` boolean: Retrieve Device Binding Info

## Response `200`

Successful Response

- TokenInquiryResponseModel
  - `header` Header
    - `error_desc` string, required: Error Description
    - `error_id` integer, required: Error Id
  - `body` VtsTokenInquiryResponse: Vts-TokenInquiryResponse
    - `panReferenceID` string
    - `operatorID` string
    - `entityOfLastAction` string
    - `walletAccountEmailAddressHash` string
    - `clientWalletAccountID` string
    - `panSource` string
    - `consumerEntryMode` string
    - `cardMetadataProfileID` string
    - `lastFourOfPAN` integer
    - `lastFourOfPreviousPAN` integer
    - `otpInfo` OTPInfo
      - `otpCodeIndicator` string
      - `otpCodeExpiration` string
      - `otpVerificationAttempts` integer
      - `otpVerificationRetryCounts` integer
    - `issuerDiscretionaryData` IssuerDiscretionaryData
      - `fileControlInformation` string
      - `issuerApplicationDiscretionaryData` string
    - `deviceBindingInfoList` DeviceBindingInfo[]
      - `deviceIndex` integer
      - `deviceID` string
      - `deviceName` string
      - `deviceBindingStatus` string
    - `decryptedData` DecryptedDataModel
      - `tokenInfo` TokenInfo
        - `token` string
        - `tokenType` 'SECURE_ELEMENT' | 'HCE' | 'CARD_ON_FILE' | 'ECOMMERCE' | 'QRC' | 'STATIC' | 'NA'
        - `tokenStatus` 'ACTIVE' | 'INACTIVE' | 'SUSPENDED' | 'DELETED' | 'DEACTIVATED' | 'CHECK_CONTEXT'
        - `tokenExpirationDate` ExpirationDate
          - `month` string
          - `year` string
        - `tokenAssuranceLevel` string
        - `numberOfActiveTokensForPAN` integer
        - `numberOfInactiveTokensForPAN` integer
        - `numberOfSuspendedTokensForPAN` integer
        - `originalToken` string
        - `originalTokenAssuranceLevel` string
        - `originalTokenRequestorID` string
        - `originalTokenReferenceID` string
        - `originalTokenType` string
        - `originalTokenAssuranceMethod` string
        - `tokenRequestorName` string
        - `autoFillIndicator` boolean
        - `tokenActivationDate` string
        - `tokenDeactivationDate` string
        - `lastTokenStatusUpdatedTime` string
        - `tokenAssuranceMethod` string
      - `deviceInfo` DeviceInfo: Mada-DeviceInfo
        - `deviceId` string: Device Id VTS: Conditional MDES/MADA: Not present Apple Pay: Required
        - `serialNumber` string: Serial number of the device. Can be masked. VTS: Not present MDES/MADA: Optional Apple Pay: Not present
        - `imei` string: The IMEI number of the device being provisioned. VTS: Not present MDES/MADA: Optional Apple Pay: Not present
        - `msisdn` string: The msisdn of the device being provisioned VTS: Not present MDES/MADA: Optional Apple Pay: Not present
        - `deviceLanguageCode` string: Valid value is any ISO 639 Version 3 VTS: Optional MDES/MADA: Not present Apple Pay: Required
        - `deviceName` string: Readable name of the device VTS: Optional MDES/MADA: Optional Apple Pay: Required
        - `isoDeviceType` string: The 2 digit device type provided on the iso messages that the token is being provisioned to. Only present when provided by a Wallet Provider VTS: Not present MDES/MADA: Optional Apple Pay: Not present
        - `deviceManufacturer` string: Manufacturer of the device VTS: Optional MDES/MADA: Not present Apple Pay: Required
        - `deviceBrand` string: Brand of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present
        - `deviceModel` string: Model of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present
        - `formFactor` string: Valid values are: PHONE, MOBILEPHONE_OR_TABLET, TABLET etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Required
        - `storageTechnology` string: Valid values are: DEVICE_MEMORY, DEVICE_MEMORY_PROTECTED, SE, TEESE etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Not present
        - `paymentTypes` string[]: Valid values are: NFC, DSRP, ECOMMERCE VTS: Not present MDES/MADA: Optional Apple Pay: Not present
        - `osName` string: Valid values are: ANDROID, WINDOWS, TIZEN, BLACKBERRY, IOS, PAGARE_EMBEDDED_OS, ANDROID_WEAR, EMBEDDED_OS VTS: Optional MDES/MADA: Optional Apple Pay: Optional
        - `osVersion` string: The version of the device operating system VTS: Optional MDES/MADA: Optional Apple Pay: Not present
        - `osBuildId` string: Operating system build identifier VTS: Optional MDES/MADA: Not present Apple Pay: Not present
        - `deviceLocation` string: Obfuscated geographic location of the device. Initially, when it is being provisioned, this contains the general location of the device. VTS: Optional MDES/MADA: Not present Apple Pay: Not present
        - `deviceIPAddressV4` string: Ip address of the device at the time of provisioning. VTS: Optional MDES/MADA: Not present Apple Pay: Not present
        - `locationSource` string: Valid values are: WIFI, CELLULAR, GPS, OTHER VTS: Optional MDES/MADA: Not present Apple Pay: Not present
        - `tokenProtectionMethod` string: Valid values are: SOFTWARE, TRUSTED_EXECUTION_ENVIRONMENT, SECURE_ELEMENT, CLOUD VTS: Optional MDES/MADA: Not present Apple Pay: Not present
        - `deviceNumber` string: Device number. VTS: Optional MDES/MADA: Not present Apple Pay: Optional
        - `fourLastDigitPhoneNumber` string: The last 4 digit of the phone number VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
        - `deviceBluetoothMac` string: The mac of the bluetooth of the device. VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
        - `timeZone` string: Device time zone TZ_Abbreviation VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
        - `timeZoneSettings` string: Valid values: NETWORK_SET, CONSUMER_SET VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
        - `deviceIndex` string: The index number from Visa where deviceId is stored. Required for token device binding. Conditional. VTS only.
        - `originalDeviceId` string
        - `originalDeviceType` string
        - `deviceIdType` string
        - `osId` string
        - `simSerialNumber` string
        - `deviceLostMode` string
        - `deviceBindingStatus` string
      - `riskInfo` RiskInformation
        - `deviceScore` string
        - `accountScore` string
        - `walletProviderRiskAssessment` string
        - `riskAssessmentScore` string
        - `walletProviderReasonCodes` string[]
        - `riskAssessmentStandardVersion` string
        - `phoneNumberScore` string
        - `tspScore` string
        - `walletScore` string
        - `cardScore` string
        - `issuerSpecialConditionCodes` string
        - `deviceInfo` DeviceInfo: Mada-DeviceInfo
          - `deviceId` string: Device Id VTS: Conditional MDES/MADA: Not present Apple Pay: Required
          - `serialNumber` string: Serial number of the device. Can be masked. VTS: Not present MDES/MADA: Optional Apple Pay: Not present
          - `imei` string: The IMEI number of the device being provisioned. VTS: Not present MDES/MADA: Optional Apple Pay: Not present
          - `msisdn` string: The msisdn of the device being provisioned VTS: Not present MDES/MADA: Optional Apple Pay: Not present
          - `deviceLanguageCode` string: Valid value is any ISO 639 Version 3 VTS: Optional MDES/MADA: Not present Apple Pay: Required
          - `deviceName` string: Readable name of the device VTS: Optional MDES/MADA: Optional Apple Pay: Required
          - `isoDeviceType` string: The 2 digit device type provided on the iso messages that the token is being provisioned to. Only present when provided by a Wallet Provider VTS: Not present MDES/MADA: Optional Apple Pay: Not present
          - `deviceManufacturer` string: Manufacturer of the device VTS: Optional MDES/MADA: Not present Apple Pay: Required
          - `deviceBrand` string: Brand of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present
          - `deviceModel` string: Model of the device VTS: Optional MDES/MADA: Not present Apple Pay: Not present
          - `formFactor` string: Valid values are: PHONE, MOBILEPHONE_OR_TABLET, TABLET etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Required
          - `storageTechnology` string: Valid values are: DEVICE_MEMORY, DEVICE_MEMORY_PROTECTED, SE, TEESE etc.. VTS: Optional MDES/MADA: Optional Apple Pay: Not present
          - `paymentTypes` string[]: Valid values are: NFC, DSRP, ECOMMERCE VTS: Not present MDES/MADA: Optional Apple Pay: Not present
          - `osName` string: Valid values are: ANDROID, WINDOWS, TIZEN, BLACKBERRY, IOS, PAGARE_EMBEDDED_OS, ANDROID_WEAR, EMBEDDED_OS VTS: Optional MDES/MADA: Optional Apple Pay: Optional
          - `osVersion` string: The version of the device operating system VTS: Optional MDES/MADA: Optional Apple Pay: Not present
          - `osBuildId` string: Operating system build identifier VTS: Optional MDES/MADA: Not present Apple Pay: Not present
          - `deviceLocation` string: Obfuscated geographic location of the device. Initially, when it is being provisioned, this contains the general location of the device. VTS: Optional MDES/MADA: Not present Apple Pay: Not present
          - `deviceIPAddressV4` string: Ip address of the device at the time of provisioning. VTS: Optional MDES/MADA: Not present Apple Pay: Not present
          - `locationSource` string: Valid values are: WIFI, CELLULAR, GPS, OTHER VTS: Optional MDES/MADA: Not present Apple Pay: Not present
          - `tokenProtectionMethod` string: Valid values are: SOFTWARE, TRUSTED_EXECUTION_ENVIRONMENT, SECURE_ELEMENT, CLOUD VTS: Optional MDES/MADA: Not present Apple Pay: Not present
          - `deviceNumber` string: Device number. VTS: Optional MDES/MADA: Not present Apple Pay: Optional
          - `fourLastDigitPhoneNumber` string: The last 4 digit of the phone number VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
          - `deviceBluetoothMac` string: The mac of the bluetooth of the device. VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
          - `timeZone` string: Device time zone TZ_Abbreviation VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
          - `timeZoneSettings` string: Valid values: NETWORK_SET, CONSUMER_SET VTS: Not Present MDES/MADA: Not present Apple Pay: Optional
          - `deviceIndex` string: The index number from Visa where deviceId is stored. Required for token device binding. Conditional. VTS only.
          - `originalDeviceId` string
          - `originalDeviceType` string
          - `deviceIdType` string
          - `osId` string
          - `simSerialNumber` string
          - `deviceLostMode` string
          - `deviceBindingStatus` string
        - `userAccountAge` string
        - `walletAccountAge` string
        - `panAge` string
        - `deviceAge` string
        - `accountToDeviceBindingAge` string
        - `daysSinceConsumerDataLastAccountChange` string
        - `accountHolderName` string
        - `walletAccountHolderCardNameMatch` string
        - `numberOfActiveTokens` string
        - `deviceTokens` string
        - `userCountry` string
        - `userWallets` string
        - `walletTransactions` string
        - `numberOfTransactionsInLast12months` string
        - `distinctCardholderNames` string
        - `suspendedCardsInAccount` string
        - `deviceWithActiveTokens` string
        - `daysSinceLastAccountActivity` string
        - `provisioningAttemptsOnDeviceIn24Hours` string
        - `deviceCountry` string
        - `visaTokenScore` string
        - `visaTokenDecisioning` string
        - `walletAccountCountry` string
        - `activeTokensOnAllDeviceForAccount` string

## Other responses

- `404`: Webservices does not exist
- `500`: Internal Server error

## Changes

- **2026-11-03** `73c2771493b1`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/paymentology/apis/payapi-docs/changes/pws/pws_vts_token_inquiry/post.md)

---

[API](https://skmtc.dev/paymentology/apis/payapi-docs.md) - [All operations](https://skmtc.dev/paymentology/apis/payapi-docs/llms.txt) - [OpenAPI document](https://skmtc.dev/paymentology/apis/payapi-docs/revisions/73c2771493b1?raw)