Card invitations

Retrieve a list of card invitations

Get the list of all card invitations in your organisation.

The results are paginated and sorted by the created_at date in reverse chronological order.

:::note To increase your account's card limits, please contact Revolut API Support. :::

For more information, see the guides: Manage card invitations.

get/card-invitations

Request

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

Query parameters

created_beforestring date-time

Retrieves only card invitations created before this timestamp (created_at < created_before). Used for pagination. 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 card invitations to return per page.

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

stateCardInvitationState[]

Retrieves card invitations filtered by the specified state(s). To specify multiple values, follow this pattern: state={VALUE1}&state={VALUE2}. If not provided, all states are returned.

Response

The list of card invitations for your business

Example response

[
  [
    {
      "expiry_date": "2025-10-20T15:09:24Z",
      "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.