Sign in
Cards

Cancel a card

Permanently cancel a card. This action cannot be undone.

post/cards/{cardId}/cancel

Path parameters

cardIdstring uuid required

Unique identifier for a card

Response

accountIdstring required

The Mercury account this card is associated with.

categoryLocksMercuryCategory[] required

Mercury spend-category locks applied to this card, in no particular order. Empty when the card has no category restrictions.

createdAtstring yyyy-mm-ddThh:MM:ssZ required

Timestamp when the card was issued.

idstring uuid required

Unique identifier for the card.

kind'debit' | 'credit' required

Whether the card is a debit or credit card.

lastFourstring required

Last four digits of the card's primary account number (PAN).

nameOnCardstring required

Cardholder name printed on the card.

nicknamestring nullable

Optional user-assigned label for the card.

physicalCardStatus'inactive' | 'active' | 'locked' nullable

Activation state of a physical card. Null for virtual cards.

status'active' | 'frozen' | 'cancelled' | 'inactive' | 'expired' | 'suspended' required

Current lifecycle state of the card.

type'virtual' | 'physical' required

Whether the card is virtual (digital-only) or physical (printed, supports ATM).

updatedAtstring yyyy-mm-ddThh:MM:ssZ required

Timestamp of the last modification to the card or its settings.

userIdstring required

Mercury User who owns the card.

Example response

{
  "createdAt": "2016-07-22T00:00:00Z",
  "expiration": {
    "month": 8,
    "year": 2026
  },
  "updatedAt": "2016-07-22T00:00:00Z"
}

Changes

Changed in 3 of the 45 revisions of this API.13

  • 7d755c9f44ae2See the full diff
    • ○

      added the optional property merchantLock to the response with the 200 status

      response-optional-property-added

    • ○

      added the required property categoryLocks to the response with the 200 status

      response-required-property-added

  • 0a8c6d8f27161See the full diff
    • ●

      added the new yearly enum value to the spendLimit/allOf[SpendLimit]/interval/allOf[SpendLimitInterval]/ response property for the response status 200

      response-property-enum-value-added

  • 314f542b4d391See the full diff
    • ○

      endpoint added

      endpoint-added