RErevolut
Cards

Retrieve card details

Get the details of 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.

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

Response

Information about the card

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.

terminated_atstring date-time

The date and time the card was terminated in ISO 8601 format. Only returned for cards in the terminated state. This is distinct from updated_at, as a terminated card can still have updates after termination.

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' | 'terminated' 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.
terminatedThe card is terminated and cannot be used. This is a final state and cannot be reversed.

:::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

{
  "terminated_at": "2026-07-22T11:15:41.113202Z",
  "references": [
    {
      "name": "PNR",
      "value": "RT12345"
    },
    {
      "name": "Traveller",
      "value": "John Smith"
    }
  ],
  "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.