RErevolut
Cards

Retrieve a list of cards

Get the list of all cards in your organisation.

The results are paginated and sorted by the created_at date in reverse chronological order. Terminated cards are not included in the list. To check the status of a specific terminated card, retrieve it by 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

Request

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

Query parameters

created_beforestring date-time

Retrieves cards with created_at < created_before. The default value is the current date and time at which you are calling the endpoint.

Provided in ISO 8601 format.

limitnumber

The maximum number of cards to return per page.

To get to the next page, make a new request and use the created_at date of the last card returned in the previous response as the value for created_before.

Response

List of cards of the business

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.