🚀 VaultsPay API v1 is live. See what's new →
Payment CardsGet Card Expiry

Get Card Expiry — Retrieve Card Expiry Date

Returns the card expiry date. This is sensitive payment data — protect access appropriately.

Limitations: Format of expiry follows the issuing system’s convention (MM/YY).

POST{gateway}/pcs/api/v1/get-card-expiry

Payload

AttributeTypeRequiredDescription
cardIdIntegerConditionalInternal card ID. Required if token not provided.
tokenIntegerConditionalCard token (PAN surrogate). Required if cardId not provided.
Request Example
{
  "cardId": 1722
}

Response

AttributeTypeDescription
dataObjectWrapper for response data.
data.expiryStringCard expiry in MM/YY format.
200 — SUCCESS
{
  "data": {
    "expiry": "27/12"
  }
}