How AI is applied across API Evangelist and APIs.io. Read my AI disclosure →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Revolut Cards API

Manage cards issued for your business, freeze, unfreeze, lock, unlock, terminate and update card settings, such as spending limits and merchant controls.:::note- This feature is not available in Sandbox.- To increase your account's card limits, please contact [Revolut API Support](mailto:api-requests@revolut.com).:::For more information, see the guides: [Manage cards for your business](https://developer.revolut.com/docs/guides/manage-accounts/cards/manage-cards).:::tip [Card invitations for onboarding team members]To prepare virtual cards for team members who have not completed onboarding yet, use [Card invitations](https://developer.revolut.com/docs/api/business#update-card-invitation) instead.:::

Revolut Cards API is one of 46 APIs that Revolut publishes on the APIs.io network, described by a machine-readable OpenAPI specification.

Tagged areas include Cards. The published artifact set on APIs.io includes an OpenAPI specification.

This API exposes 12 operations across 9 paths, and defines 19 schemas. It is described by OpenAPI 3.2.0, at version 1.0.

Requests are made against 2 base URLs: https://b2b.revolut.com/api/1.0, https://sandbox-b2b.revolut.com/api/1.0.

12 operations 9 paths 19 schemas 1 DELETE3 GET1 PATCH5 POST2 PUT

Metadata

The identity and technical contract details declared by the specification.

Specification
OpenAPI 3.2.0
API Version
1.0
Base URL
https://b2b.revolut.com/api/1.0
Authentication
HTTP Bearer
Resource Areas
1

Authentication & Security 1

Revolut Cards API declares 1 security scheme for authenticating requests. It accepts HTTP bearer tokens (AccessToken).

  • AccessToken — Each Business API request must contain an authorization header in the following format to make a call: Bearer . The access token will be obtained the first tim…

Paths & Operations 12

Across 9 paths, the API surfaces 12 operations — 1 DELETE, 3 GET, 1 PATCH, 5 POST, 2 PUT. Each is listed below with its method, path, parameters, and response codes.

Cards 12

Manage cards issued for your business, freeze, unfreeze, lock, unlock, terminate and update card settings, such as spending limits and merchant controls. :::note - This feature is…

GET
/cards
Retrieve a list of cards
getCards 2 params → 200400default
POST
/cards
Create a card
createCard body → 200400404422429default
GET
/cards/{card_id}
Retrieve card details
getCard 1 param → 200400404default
PATCH
/cards/{card_id}
Update card settings
updateCard 1 param body → 200400404422default
DELETE
/cards/{card_id}
Terminate a card
deleteCard 1 param → 204400404default
PUT
/cards/{card_id}/contacts
Update card contacts
updateCardContacts 1 param body → 200400404422default
PUT
/cards/{card_id}/references
Update card references
updateCardReferences 1 param body → 200400404422default
POST
/cards/{card_id}/freeze
Freeze a card
freezeCard 1 param → 204400403404default
POST
/cards/{card_id}/unfreeze
Unfreeze a card
unfreezeCard 1 param → 204400403404default
POST
/cards/{card_id}/lock
Lock a card
lockCard 1 param → 204400403404default
POST
/cards/{card_id}/unlock
Unlock a card
unlockCard 1 param → 204400403404default
GET
/cards/{card_id}/sensitive-details
Retrieve sensitive card details
getSensitiveCardDetails 1 param → 200400403404default

Schemas 19

The contract defines 19 schemas that model the data the API accepts and returns. The most detailed are CardResponse (20 properties), CardCreatedResponse (19 properties), SpendingLimitsSchema (7 properties), SpendingPeriodSchema (3 properties). Each schema is shown below with its type and property counts.

CardState
string
The state that the card is in. Possible values: - active: The card is available for spending. Newly created cards typically go into active unless subject to ce…
TransactionLimitCurrency
string
The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO4217) code in upper case.
CardProduct
object
The card product offered by the card provider for this card. In other words, the program that the card was issued under. :::note This property is only availabl…
1 property 1 required
CardReference
object
Reference for the card. One of the name-value pairs assigned to the card for tracking. :::info Each time the card is used, the references are recorded in the […
2 properties 2 required
CardResponse
object
20 properties 8 required
CardReferences
array
References for the card. Up to 5 name-value pairs assigned to the card for tracking. :::info Each time the card is used, the references are recorded in the [tr…
CardContacts
array
The list of contacts for a [company card](https://developer.revolut.com/docs/guides/manage-accounts/cards/manage-cardsdifferent-types-of-cards).
SpendingLimitPeriodic
object
The limit for transactions within a given period.
2 properties 2 required
MerchantControlsSchema
object
2 properties 2 required
SpendingPeriodSchema
object
3 properties
CardsResponse
array
A list of cards.
SpendingLimitsSchema
object
7 properties
SpendProgram
object
The [spend program](https://help.revolut.com/business/help/making-paymentsbusiness/spend-controls/setting-card-presets-for-my-team-members/) assigned to the ca…
1 property 1 required
Error
object
2 properties 2 required
SpendingLimitSingleTransaction
object
The limit for a single transaction.
2 properties 2 required
CardCreatedResponse
object
19 properties 8 required
BusinessMerchantCategory
string
CardCanBeUnlocked
boolean
Returned for locked cards (state=locked). Indicates whether the card can be [unlocked](https://developer.revolut.com/docs/api/businessunlock-card) manually (vi…
CardContact
string
One of the card's contacts.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revolut-cards-api-openapi.yml Raw ↑

Other APIs Revolut publishes across the network.

Revolut Accounting API
Revolut Accounting categories API
Revolut Accounts API
Revolut Apple Pay merchant registration API
Revolut Applications API
Revolut Balance API
Revolut Card invitations API
Revolut Configuration API
Revolut Counterparties API
Revolut Customers API
Revolut Disputes API
Revolut Domestic payment API
Where this information came from

This is an independent, third-party profile of Revolut Cards API, published by API Evangelist. We do not operate, host, resell, or support these APIs, and we are not affiliated with or endorsed by the company unless stated above. Everything here is built from publicly available information — the company's own site, developer portal, documentation, public repositories, and the specifications it publishes for public use. Nothing is obtained by breaching a system, defeating an access control, or using credentials.

The Kin Score and Agent Readiness rating are independently calculated assessments of a company's public API artifacts, scored against a published rubric. They are not certifications, endorsements, security assessments, or audits.

Corrections, re-scores, and removal are free — no partnership or purchase required, and you do not need to justify the request. A removed company is recorded as unrated, never scored zero for having asked. Acknowledgement within one business day; removal within two.

info@apievangelist.com · Read the full data-sourcing policy →
On a security or compliance team? Put security in the subject line and you will get a person, not a form — we will tell you exactly which public URLs this profile was built from.