# Get masked card data related to gateway token

Request to get card data related to the gateway token. The returned sensitive data is unencrypted but masked to ensure security.

Endpoint: GET /token-vault/{ownerType}/{ownerId}/vaults/gateway-tokens/{gatewayTokenId}/card-data
Version: 1.0.0

## Path parameters:

  - `ownerId` (string, required)
    The identifier of the vault owner. This must match the owner type. For example, provide your merchant group ID when ownerType is MerchantGroup.
    Example: "MERCHANT-GROUP-1"

  - `ownerType` (string, required)
    The type of entity that owns the token vault. Use with ownerId to identify which vault to use.
    Enum: "Referrer", "MerchantGroup", "Merchant", "Site"

  - `gatewayTokenId` (string, required)
    The gateway token ID.
    Example: "7f46c09d-d1d1-4f94-9a88-6e8ac32e6341"

## Response 200 fields (application/json):

  - `maskedPrimaryAccountNumber` (string)
    The masked primary account number (PAN) of the card.
    Example: "123456******7890"

  - `expiryMonth` (string)
    The expiry month of the card, as a number from 1 to 12. Typically zero-padded to two digits (for example, 03).
    Example: "03"

  - `expiryYear` (string)
    The expiry year of the card (YYYY).
    Example: "2025"

  - `holderName` (string)
    The Cardholder Name represents the full name of the individual who owns the payment card. This name is printed on the physical card and is used for verifying the cardholder's identity during transactions. The cardholder name is a vital component for transaction processing, especially in cases of card-not-present transactions like online purchases. It should be treated with confidentiality to safeguard the cardholder's privacy and prevent potential misuse.
    Example: "Mr John Doe"

  - `fundingSource` (string,null)
    The funding source type of the card.
    Enum: "Credit", "Debit", "Prepaid"

## Response 400 fields (application/json):

  - `correlationId` (string)
    The unique identifier for this error response. Include it when contacting PXP support.
    Example: "81f32b80-2ba0-4430-8ecd-0b559274ba9c"

  - `details` (array)
    Additional details about the error.

  - `errorCode` (string)
    The error code returned for the operation.
    Example: "INVALID_REQUEST"

  - `errorReason` (string)
    The error reason returned for the operation.
    Example: "The request parameters are invalid."