# Get Payment Data By Token

Retrieve the a payment data associated with a specific token. This will return meta data about the payment data but not the sensitive payment data.

Endpoint: GET /token-service/tokens/metadata
Version: 0.0.8
Security: bearerAuth

## Request fields (application/json):

  - `token` (string, required)
    Token that would be decrypted.
    Example: "e4eaaaf2-d142-11e1-b3e4-080027620cdd"

  - `types` (array)
    Type of decrypted details that would be returned.
    Example: ["ACH","PAN"]

## Response 200 fields (application/json):

  - `responseCode` (string, required)
    A code that represents the outcome of the transaction
    Example: "0"

  - `type` (string)
    Type of token

  - `token` (string)
    Token in UUID format
    Example: "85ce5afd-31b2-4612-a6ef-c1e2aba3ca71"

  - `formatPreservedToken` (string)
    Format preserved token

  - `creditCard` (object)
    PAN details

  - `creditCard.cardNumber` (string)
    The credit card number.
    Example: "4111111111111111"

  - `creditCard.expiration` (string)
    Expiration date of the card
    Example: "1230"

  - `creditCard.bin` (string)
    Bank Identification Number
    Example: "40212300"

  - `creditCard.category` (string)
    Only present for CC: credit card, debit card, cash card
    Example: "Credit Card"

  - `creditCard.lastFour` (string)
    Only present for CC: last 4 of card number
    Example: "4444"

  - `creditCard.binLevel` (string)
    Hierarchical level or classification of the card
    Example: "Platinum"

  - `creditCard.binLength` (integer)
    Only present for CC: BIN length
    Example: 8

  - `creditCard.network` (string)
    Only present for CC: card brand like Visa
    Example: "VISA"

  - `creditCard.isoCountry` (string)
    Country code representing the country associated with the payment account
    Example: "UNITED STATES OF AMERICA (THE)"

  - `creditCard.isoCountryCode` (string)
    Country code indicating the country where the payment account's issuing institution is located
    Example: "840"

  - `creditCard.isInternational` (boolean)
    Flag indicating whether the payment account is considered international

  - `bankAccount` (object)
    ACH details

  - `bankAccount.accountNumber` (string)
    The bank account number.
    Example: "459887746321Z"

  - `bankAccount.routingNumber` (string)
    The bank routing number.
    Example: "123456789012"

  - `bankAccount.accountType` (string)
    The type of bank account.
    Enum: "Savings", "Checking"

  - `bankAccount.tenderType` (string)
    The bank tender type.
    Enum: "Consumer", "Commercial"

  - `dpan` (object)
    DPAN details

  - `dpan.applicationPrimaryAccountNumber` (string)
    Application Primary Account Number (DPAN)
    Example: "4111111111111111"

  - `dpan.applicationExpirationDate` (string)
    Application expiration date
    Example: "2025-12-01T00:00:00Z"

  - `dpan.currencyCode` (string)
    Currency code
    Example: "840"

  - `dpan.transactionAmount` (number)
    Transaction amount
    Example: 2089

  - `dpan.cardholderName` (string)
    Cardholder name
    Example: "John Doe"

  - `dpan.deviceManufacturerIdentifier` (string)
    Device manufacturer identifier
    Example: "040010030273"

  - `dpan.paymentDataType` (string)
    Payment data type
    Example: "3DSecure"

  - `dpan.onlinePaymentCryptogram` (string)
    Online payment cryptogram
    Example: "AgAAAAAAAIR8CQrXcIIBAAA="

  - `dpan.eciIndicator` (string)
    ECI indicator
    Example: "05"

  - `dpan.authenticationResponses` (array)
    Authentication responses
    Example: [{"merchantIdentifier":"...","authenticationData":"...","transactionAmount":"2000"}]

  - `dpan.authenticationResponses.merchantIdentifier` (string)

  - `dpan.authenticationResponses.authenticationData` (string)

  - `dpan.authenticationResponses.transactionAmount` (string)

  - `dpan.expiration` (string)
    Expiration date of the DPAN data
    Example: "2025-12-01T00:00:00Z"

  - `dpan.digitalWallet` (string)
    Type of digital wallet

  - `mpan` (object)
    MPAN details

  - `mpan.merchantTokenIdentifier` (string)
    Merchant token identifier
    Example: "DNITHE302483952"

  - `mpan.merchantTokenMetadata` (object)
    Merchant token metadata (JSON string)
    Example: {"merchantId":"123456","tokenRequestorId":"40010030273"}

  - `mpan.merchantTokenMetadata.cardMetadata` (object)

  - `mpan.merchantTokenMetadata.cardMetadata.longDescription` (string)

  - `mpan.merchantTokenMetadata.cardMetadata.cardCountry` (string)

  - `mpan.merchantTokenMetadata.cardMetadata.shortDescription` (string)

  - `mpan.merchantTokenMetadata.cardMetadata.fpanSuffix` (string)

  - `mpan.expiration` (string)
    Expire date of the MPAN data
    Example: "0728"

  - `responseMessage` (string)
    A list of brief descriptions about the error encountered. If multiple messages need to be returned, it will be separated with ';' character
    Example: "An unexpected system error occurred. Please check with support."