RErevolut
Cards

Update card settings

Update settings for a specific card, based on its ID.

:::note To increase your account's card limits, please contact Revolut API Support. :::

For more information, see the guides: Manage cards.

patch/cards/{card_id}

Request

  • Base URL
    https://b2b.revolut.com/api/1.0
  • Auth
    HTTP bearer

Path parameters

card_idstring uuid required

The ID of the card.

Request body

labelstring

The label of the card.

categoriesBusinessMerchantCategory[]

The list of merchant categories that will be available for card spending. Use null to erase the value and reset to empty (all categories will be allowed).

countriesstring[]

The list of countries where the card can be used, provided as 2-letter ISO 3166 codes.

accountsstring[]

The list of accounts to link to the card. If not specified, all accounts will be linked. To retrieve account IDs, use the GET /accounts operation.

Example request

{
  "spending_limits": {
    "single": {
      "amount": 200.22,
      "currency": "GBP"
    },
    "week": {
      "amount": 200.44,
      "currency": "GBP"
    }
  },
  "spending_period": {
    "start_date": "2025-09-26",
    "end_date": "2030-12-31"
  },
  "mcc_controls": {
    "mccs": [
      "7033"
    ]
  },
  "countries": [
    "GB"
  ]
}

Response

Information about the updated card

:::note If you modify the card's spending period in the request, the card's state returned in the response might not yet reflect those changes. This is because these spending period locks are applied to the card asynchronously, which might result in a slight delay in the card's state update.

To re-check the state, fetch the card's details. :::

idstring uuid required

The ID of the card.

holder_idstring uuid

The ID of the team member who is the holder of the card. If the card belongs to the business, this will be empty.

For more information, see the guides: Manage Cards - Create a virtual card.

contact_idsCardContact[]

The list of contacts for a company card.

created_atstring date-time required

The date and time the card was created in ISO 8601 format.

updated_atstring date-time required

The date and time the card was last updated in ISO 8601 format.

virtualboolean required

Specifies whether the card is virtual (true) or physical (false).

last_digitsstring required

The last 4 digits of the card's PAN.

expirystring MM/YYYY required

The card expiration date.

labelstring

The label of the card.

state'created' | 'pending' | 'active' | 'frozen' | 'locked' required

The state that the card is in.

Possible values:

ValueDescription
activeThe card is available for spending. Newly created cards typically go into active unless subject to certain conditions, for example, spending period starting in the future.
frozenThe card has been frozen and is temporarily unavailable for spending.
lockedThe card is locked, typically due to an admin lock or spending period settings, i.e. when its spending_period.start_date is in the future or spending_period.end_date is in the past. A locked card is unavailable for spending until it's unlocked and active.
createdThe card has been created but is not yet active. Used only for a specific type of cards.
pendingThis status is currently not in use.

:::tip[Card locked?] To see if the card can be unlocked, check the can_be_unlocked parameter. Note that you'll still need the necessary scope or permission to unlock it. :::

can_be_unlockedboolean

Returned for locked cards (state=locked). Indicates whether the card can be unlocked manually (via API or in-app). If true, you'll still need the necessary scope or permission to unlock the card.

:::info Cards can be locked for various reasons. For example, a card can be locked by the user, due to spending period settings, or automatically by the system. Only certain types of lock can be lifted manually. :::

categoriesBusinessMerchantCategory[]

The list of merchant categories that are available for card spending. If not specified, categories are not restricted.

countriesstring[]

The list of countries where the card can be used, specified as 2-letter ISO 3166 codes.

accountsstring[] required

The list of linked accounts.

Example response

{
  "references": [
    {
      "name": "PNR",
      "value": "RT12345"
    },
    {
      "name": "Traveller",
      "value": "John Smith"
    }
  ],
  "spending_limits": {
    "single": {
      "amount": 200.22,
      "currency": "GBP"
    },
    "week": {
      "amount": 200.44,
      "currency": "GBP"
    }
  },
  "spending_period": {
    "start_date": "2025-09-26",
    "end_date": "2030-12-31"
  },
  "mcc_controls": {
    "mccs": [
      "7033"
    ]
  },
  "countries": [
    "GB"
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.