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

Documentation Provider Profile APIs.io OpenAPI GitHub

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

5 operations 3 paths 30 schemas 2 GET1 PATCH2 POST

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

CardInvitationUpdatedAt
string
The date and time the card invitation was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO8601) format.
SpendingLimitPeriodic
object
The limit for transactions within a given period.
2 properties 2 required
CardInvitationAccounts
array
The list of accounts that will be linked to the card.
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…
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
CardInvitationCardId
string
The ID of the card issued after this invitation was claimed. :::note Only returned for invitations in state redeemed. :::
Error
object
2 properties 2 required
MerchantControlsSchema
object
2 properties 2 required
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…
SpendingPeriodSchema
object
3 properties
CardInvitationCreatedResponse
object
14 properties 6 required
BusinessMerchantCategory
string
ErrorUnauthorized
object
Unauthorised Returned, for example, when the credentials you used to make the request are invalid. For more information, see the Authorization section.
SpendingLimitSingleTransaction
object
The limit for a single transaction.
2 properties 2 required
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
CardInvitationLabel
string
The label of the card.
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…
ErrorWithStatus
object
Error returning a status instead of code.
2 properties 2 required
CardInvitationsResponse
array
A list of card invitations
TransactionLimitCurrency
string
The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO4217) code in upper case.
CardInvitationResponse
object
16 properties 6 required
SpendingLimitsSchema
object
7 properties
CardInvitationVirtual
boolean
Specifies whether the issued card will be a virtual (true) or physical (false) one.
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…
CardInvitationUpdatedResponse
object
15 properties 6 required
CardInvitationCreatedAt
string
The date and time the card invitation was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO8601) format.
CardInvitationId
string
The ID of the card invitation.
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.
CardInvitationCategories
array
The list of merchant categories that will be available for card spending. If this parameter is not specified, categories are not restricted.

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
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 Cards 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
#Card invitations
← Back to R APIs
API Details
ID
revolut:revolut-card-invitations-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