Need help with your APIs? I offer API discovery, governance & evangelism services. Explore services →
API Evangelist API Evangelist
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC
Discovery
Learnings
Guidance
Toolbox
Alignment
API Evangelist LLC

Need help?

Contact us
Kin Lane

Chat with Kin

AI assistant · trained on my blog

Revolut

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

Documentation Provider Profile APIs.io OpenAPI GitHub

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.0.1, 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.0.1
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.

SpendingLimitPeriodic
object
The limit for transactions within a given period.
2 properties 2 required
CardContact
string
One of the card's contacts.
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
CardResponse
object
20 properties 8 required
CardCreatedResponse
object
19 properties 8 required
CardContacts
array
The list of contacts for a [company card](https://developer.revolut.com/docs/guides/manage-accounts/cards/manage-cardsdifferent-types-of-cards).
Error
object
2 properties 2 required
MerchantControlsSchema
object
2 properties 2 required
SpendingPeriodSchema
object
3 properties
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…
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
BusinessMerchantCategory
string
SpendingLimitSingleTransaction
object
The limit for a single transaction.
2 properties 2 required
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…
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
SpendingLimitsSchema
object
7 properties
CardsResponse
array
A list of cards.
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…

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
AE Profile APIs.io
Revolut Accounting categories API
AE Profile APIs.io
Revolut Accounts API
AE Profile APIs.io
Revolut Apple Pay merchant registration API
AE Profile APIs.io
Revolut Applications API
AE Profile APIs.io
Revolut Balance API
AE Profile APIs.io
Revolut Card invitations API
AE Profile APIs.io
Revolut Configuration API
AE Profile APIs.io
Revolut Counterparties API
AE Profile APIs.io
Revolut Customers API
AE Profile APIs.io
Revolut Disputes API
AE Profile APIs.io
Revolut Domestic payment API
AE Profile APIs.io
#Cards
← Back to R APIs
API Details
ID
revolut:revolut-cards-api
Base URL
https://b2b.revolut.com/api/1.0
Docs
https://developer.revolut.com/docs/business/business-api
Provider
Revolut
APIs.io →  GitHub →
Explore more
All APIs Providers APIs.io Network