---
title: "Mada Token Inquiry"
method: POST
path: "/pws/pws_mada_token_inquiry"
tags: ["Mada Pay LCM"]
---

# Mada Token Inquiry

`POST /pws/pws_mada_token_inquiry`

Mada Token Inquiry

## Request body

- TokenInquiryInternal — Mada-TokenInquiryInternal
  - `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 — Inquired public token
  - `user_id` string — User Id of the Customer who triggered the API request.
  - `remarks` string — Remarks for API request
  - `tokenReferenceID` string — Unique ID for the Token associated with the PAN.

## Response `200`

Successful Response

- ResponseTokenInquiry
  - `header` Header
    - `error_desc` string, required — Error Description
    - `error_id` integer, required — Error Id
  - `body` TokenInquiryResponse — Mada-TokenInquiryResponse
    - `actionCode` string, required — Action Code : 00 - Success, 01 - Failure
    - `responseId` string — responseId
    - `accounts` Account[] — Account
      - `accountPanSuffix` string
      - `financialAccountSuffix` string
      - `countryCode` string
      - `interbankCardAssociationId` string
      - `institutionName` string
      - `expirationDate` ExpirationDate
        - `month` string
        - `year` string
      - `tokens` TokenDetail[]
        - `panReferenceId` string
        - `tokenReferenceId` string
        - `tokenRequestorId` string
        - `tokenRequestorName` string
        - `issuerPanReferenceId` string
        - `correlationId` string
        - `walletAccountId` string
        - `accountIdHash` string
        - `tokenAssuranceLevel` string
        - `tokenExpiry` ExpirationDate
          - `month` string
          - `year` string
        - `tokenStatus` string
        - `tokenType` string
        - `deactivationDate` string
        - `lastTokenStatusUpdatedTimestamp` string
        - `entityOfLastAction` string
        - `operatorId` 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
        - `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
        - `otpCodeIndicator` string
        - `otpCodeExpiration` string
        - `otpVerificationAttempts` integer
        - `otpVerificationRetryCounts` integer
        - `last4ofPAN` string
        - `last4ofPrevPAN` string
        - `provisioningTime` string
        - `lastReplenishTime` string
        - `issuerCardholderId` string
        - `walletProviderId` string
        - `currentStatusDescription` string
        - `digitizationRequestDateTime` string
        - `finalTokenizationDecision` string
        - `lastCommentId` string
        - `paymentAppInstanceId` string
        - `provisioningStatusCode` string
        - `provisioningStatusDescription` string
        - `storageTechnology` string
        - `suspenders` string[]
        - `tokenActivatedDateTime` string
        - `walletId` string
        - `tokenDeletedFromConsumerApp` string
        - `tokenSuffix` string
        - `originalToken` string
        - `originalTokenRequestorId` integer
        - `originalTokenReferenceId` string
        - `originalTokenAssuranceMethod` string
        - `tokenAssuranceMethod` string
        - `originalTokenType` string
        - `autoFillIndicator` boolean
        - `panSource` string
        - `consumerEntryMode` string
        - `cardMetadataProfileId` string
        - `issuerDiscretionaryData` DiscretionaryDataInfo
          - `fileControlInformation` string
          - `issuerApplicationDiscretionaryData` string
        - `cardholderVerificationList` CardHolderVerificationList
          - `lifeCycleTraceID` string
          - `status` string
          - `timestamp` string
        - `numberOfActiveTokensForPAN` string
        - `numberOfInactiveTokensForPAN` string
        - `numberOfSuspendedTokensForPAN` string
        - `Token` string
    - `deviceBindingInfoList` DeviceInfo[] — Device Binding List
      - `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

## Other responses

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

---

[API](https://skmtc.net/paymentology/apis/payapi-docs.md) · [All operations](https://skmtc.net/paymentology/apis/payapi-docs/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/paymentology/payapi-docs/revisions/a675891b0365/schema)