RErevolut
Card invitations

Update card invitation settings

Update settings for a specific card invitation, based on its ID. You can update successfully created invitations that have not been claimed yet (state=created).

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

For more information, see the guides: Manage card invitations.

patch/card-invitations/{card_invitation_id}

Request

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

Path parameters

card_invitation_idstring uuid required

The ID of the card invitation.

Request body

labelstring

The label of the card.

Cards without labels are not allowed. If set to null, the default label will be set according to the card's type.

:::tip[Default labels] For virtual cards, the default label is Virtual. For physical cards, depending on the type, it can be, for example, Standard or Metal.

As these values depend on available card types, they are subject to change over time. :::

categoriesBusinessMerchantCategory[]

The list of merchant categories to 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 invitation

idstring uuid required

The ID of the card invitation.

state'created' | 'expired' | 'failed' | 'redeemed' required

The current state of the card invitation:

ValueDescription
createdInvitation has been created but not yet claimed.
expiredInvitation has expired due to expiry date being reached or manual cancellation.
failedInvitation claim attempt failed.
redeemedInvitation has been successfully claimed.

To learn more about card invitation lifecycle, see the guide: Manage card invitations → Card invitation state.

created_atstring date-time required

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

updated_atstring date-time required

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

expiry_datestring date-time

The date and time after which this card invitation expires if not claimed or cancelled before then. Specified in ISO 8601 format. :::note Only returned for invitations in state created. :::tip For other states, to find out when a card invitation transitioned to its final state, check the updated_at value. :::

holder_idstring uuid

The ID of the team member to be assigned as the holder of the card after the invitation is claimed.

virtualboolean required

Specifies whether the issued card will be a virtual (true) or physical (false) one.

labelstring

The label of the card.

categoriesBusinessMerchantCategory[]

The list of merchant categories that will be available for card spending.
If this parameter is not specified, categories are not restricted.

countriesstring[]

The list of countries where the team member will be able to use the card. Specified as 2-letter ISO 3166 codes.

accountsstring[] required

The list of accounts that will be linked to the card.

Example response

{
  "expiry_date": "2025-10-20T15:09:24Z",
  "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.