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 Card invitations API

Use card invitations to pre-create cards for [team members](https://developer.revolut.com/docs/guides/manage-accounts/teams/manage-team-members) who have not yet onboarded.Once the team member completes onboarding, the card is automatically issued as per the configuration specified in the invitation.You can also retrieve and update the invitations, or cancel them if they're no longer needed.:::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 card invitations](https://developer.revolut.com/docs/guides/manage-accounts/cards/manage-card-invitations).

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

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

This API exposes 5 operations across 3 paths, and defines 30 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.

5 operations 3 paths 30 schemas 2 GET1 PATCH2 POST

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 Card invitations 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 5

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

Card invitations 5

Use card invitations to pre-create cards for [team members](https://developer.revolut.com/docs/guides/manage-accounts/teams/manage-team-members) who have not yet onboarded. Once t…

POST
/card-invitations
Create a card invitation
createCardInvitation body → 200400401404422429default
GET
/card-invitations
Retrieve a list of card invitations
getCardInvitations 3 params → 200400401default
GET
/card-invitations/{card_invitation_id}
Retrieve card invitation details
getCardInvitation 1 param → 200400401404default
PATCH
/card-invitations/{card_invitation_id}
Update card invitation settings
updateCardInvitation 1 param body → 200400401404422default
POST
/card-invitations/{cardInvitationId}/cancel
Cancel a card invitation
cancelCardInvitation 1 param → 204400401404422default

Schemas 30

The contract defines 30 schemas that model the data the API accepts and returns. The most detailed are CardInvitationResponse (16 properties), CardInvitationUpdatedResponse (15 properties), CardInvitationCreatedResponse (14 properties), SpendingLimitsSchema (7 properties). Each schema is shown below with its type and property counts.

CardInvitationResponse
object
16 properties 6 required
ErrorWithStatus
object
Error returning a status instead of code.
2 properties 2 required
CardInvitationsResponse
array
A list of card invitations
CardInvitationState
string
The current state of the card invitation: - created: Invitation has been created but not yet claimed. - expired: Invitation has expired due to expiry date bein…
CardInvitationHolderId
string
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 invit…
CardInvitationCardId
string
The ID of the card issued after this invitation was claimed. :::note Only returned for invitations in state redeemed. :::
ErrorUnauthorized
object
Unauthorised Returned, for example, when the credentials you used to make the request are invalid. For more information, see the Authorization section.
CardInvitationVirtual
boolean
Specifies whether the issued card will be a virtual (true) or physical (false) one.
TransactionLimitCurrency
string
The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO4217) code in upper case.
CardInvitationAccounts
array
The list of accounts that will be linked to the card.
ErrorUnprocessableEntity
object
Unprocessable entity Returned, for example, when you try to modify a resource which is not a in state that would allow for modifications, e.g. a card invitatio…
2 properties 1 required
CardInvitationSpendingPeriod
object
The controls for the card's spending period. They specify the dates when the card will become available or unavailable for spending, and define what happens af…
CardInvitationLabel
string
The label of the card.
SpendingLimitPeriodic
object
The limit for transactions within a given period.
2 properties 2 required
MerchantControlsSchema
object
2 properties 2 required
SpendingPeriodSchema
object
3 properties
CardInvitationExpiryDate
string
The date and time after which this card invitation expires if not claimed or cancelled before then. Specified in [ISO 8601](https://en.wikipedia.org/wiki/ISO86…
CardInvitationCreatedHolderId
string
The ID of the team member to be assigned as the holder of the card after the invitation is claimed.
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
CardInvitationId
string
The ID of the card invitation.
Error
object
2 properties 2 required
CardInvitationCategories
array
The list of merchant categories that will be available for card spending. If this parameter is not specified, categories are not restricted.
SpendingLimitSingleTransaction
object
The limit for a single transaction.
2 properties 2 required
CardInvitationCreatedResponse
object
14 properties 6 required
BusinessMerchantCategory
string
CardInvitationUpdatedResponse
object
15 properties 6 required
CardInvitationCountries
array
The list of countries where the team member will be able to use the card. Specified as 2-letter [ISO 3166](https://en.wikipedia.org/wiki/ListofISO3166countryco…
CardInvitationCreatedAt
string
The date and time the card invitation was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO8601) format.
CardInvitationUpdatedAt
string
The date and time the card invitation was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO8601) format.

Specification

The full machine-readable OpenAPI contract behind this narrative.

Source

revolut-card-invitations-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 Cards 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 Card invitations 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.