RErevolut
Card invitations

Retrieve card invitation details

Get the details of a specific card invitation, based on its ID.

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

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

get/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.

Response

Information about the 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. :::

card_idstring uuid

The ID of the card issued after this invitation was claimed. :::note Only returned for invitations in state redeemed. :::

holder_idstring uuid

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

:::note If the team member has been deleted since the invitation was created, the holder_id is not returned. :::

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.