Cards

Freeze a card

Temporarily freeze a card. The card must be active.

post/cards/{cardId}/freeze

Path parameters

cardIdstring uuid required

Unique identifier for a card

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.

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.

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

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

Jul 14, 20267d755c9f44ae2See the full diff
- ○
  added the optional property to the response with the status
  response-optional-property-added
- ○
  added the required property to the response with the status
  response-required-property-added
Jun 16, 20260a8c6d8f27161See the full diff
- ●
  added the new yearly enum value to the ///////// response property for the response status
  response-property-enum-value-added
Apr 28, 2026314f542b4d391See the full diff
- ○
  endpoint added
  endpoint-added