MEmercurytechnologies
Cards

Cancel a card

Changed on

Permanently cancel a card. This action cannot be undone.

post/cards/{cardId}/cancel

Request

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.

isAgentCardboolean required

Whether the card is managed by the agentic spend-management agent. Only agent cards can have their full details revealed.

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.

spendLimitType'cardLimit' | 'budgets' required

Whether card-level limits or budgets govern purchase spending.

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