---
title: "Retrieve a list of card invitations"
method: GET
path: "/card-invitations"
tags: ["Card invitations"]
---

# Retrieve a list of card invitations

`GET /card-invitations`

## Request

- Base URL: `https://b2b.revolut.com/api/1.0`
- URL: `https://b2b.revolut.com/api/1.0/card-invitations`
- Auth: HTTP bearer

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

## Query parameters

- `created_before` string, date-time
- `limit` number
- `state` CardInvitationState[]

## Response `200`

The list of card invitations for your business

- CardInvitationsResponse[]
  - CardInvitationResponse[]: A list of card invitations
    - `id` string, uuid, required: The ID of the card invitation.
    - `state` 'created' | 'expired' | 'failed' | 'redeemed', required: The current state of the card invitation: | Value | Description | | --- | --- | | **`created`** | Invitation has been created but not yet claimed. | | **`expired`** | Invitation has expired due to expiry date being reached or manual cancellation. | | **`failed`** | Invitation claim attempt failed. | | **`redeemed`** | Invitation has been successfully claimed. | To learn more about card invitation lifecycle, see the guide: [Manage card invitations → Card invitation state](https://developer.revolut.com/docs/guides/manage-accounts/cards/manage-card-invitations#card-invitation-state).
    - `created_at` string, date-time, required: The date and time the card invitation was created in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `updated_at` string, date-time, required: The date and time the card invitation was last updated in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format.
    - `expiry_date` string, date-time: 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/ISO_8601) format. :::note Only returned for invitations in state `created`. :::tip For other states, to find out when a card invitation transitioned to its [final state](https://developer.revolut.com/docs/guides/manage-accounts/cards/manage-card-invitations#card-invitation-state), check the `updated_at` value. :::
    - `card_id` string, uuid: The ID of the card issued after this invitation was claimed. :::note Only returned for invitations in state `redeemed`. :::
    - `holder_id` string, uuid: 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 invitation was created, the `holder_id` is not returned. :::
    - `virtual` boolean, required: Specifies whether the issued card will be a virtual (`true`) or physical (`false`) one.
    - `label` string: The label of the card.
    - `spend_program` SpendProgram: The [spend program](https://help.revolut.com/business/help/making-paymentsbusiness/spend-controls/setting-card-presets-for-my-team-members/) assigned to the card. :::note To use this property, please contact [Revolut API Support](mailto:api-requests@revolut.com). :::
      - `label` string, required: The name of the spend program.
    - `spending_limits` SpendingLimitsSchema
      - `single` SpendingLimitSingleTransaction: The limit for a single transaction.
        - `amount` number, double, required: The value of the spending limit.
        - `currency` string, required: The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code in upper case.
      - `day` SpendingLimitPeriodic: The limit for transactions within a given period.
        - `amount` number, double, required: The value of the spending limit.
        - `currency` string, required: The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code in upper case.
      - `week` SpendingLimitPeriodic: The limit for transactions within a given period.
        - `amount` number, double, required: The value of the spending limit.
        - `currency` string, required: The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code in upper case.
      - `month` SpendingLimitPeriodic: The limit for transactions within a given period.
        - `amount` number, double, required: The value of the spending limit.
        - `currency` string, required: The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code in upper case.
      - `quarter` SpendingLimitPeriodic: The limit for transactions within a given period.
        - `amount` number, double, required: The value of the spending limit.
        - `currency` string, required: The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code in upper case.
      - `year` SpendingLimitPeriodic: The limit for transactions within a given period.
        - `amount` number, double, required: The value of the spending limit.
        - `currency` string, required: The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code in upper case.
      - `all_time` SpendingLimitPeriodic: The limit for transactions within a given period.
        - `amount` number, double, required: The value of the spending limit.
        - `currency` string, required: The currency of the spending limit, provided as [ISO 4217](https://en.wikipedia.org/wiki/ISO_4217) code in upper case.
    - `spending_period` union
      - object
        - `start_date` string, date, required: The start date (inclusive) of the spending period, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DD`). Uses the [timezone set by the business](https://business.revolut.com/settings/appearance), or defaults to `Europe/London`.
        - `end_date` string, date: The end date (inclusive) of the spending period, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DD`). Uses the [timezone set by the business](https://business.revolut.com/settings/appearance), or defaults to `Europe/London`.
        - `end_date_action` 'lock' | 'terminate': The action to take after the end date of the spending period.
      - object
        - `start_date` string, date: The start date (inclusive) of the spending period, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DD`). Uses the [timezone set by the business](https://business.revolut.com/settings/appearance), or defaults to `Europe/London`.
        - `end_date` string, date, required: The end date (inclusive) of the spending period, in [ISO 8601](https://en.wikipedia.org/wiki/ISO_8601) format (`YYYY-MM-DD`). Uses the [timezone set by the business](https://business.revolut.com/settings/appearance), or defaults to `Europe/London`.
        - `end_date_action` 'lock' | 'terminate', required: The action to take after the end date of the spending period.
    - `categories` BusinessMerchantCategory[]: The list of merchant categories that will be available for card spending. If this parameter is not specified, categories are not restricted.
    - `merchant_controls` MerchantControlsSchema: The merchant-level controls for card spending.
      - `control_type` 'block' | 'allow', required: The type of control to apply. Possible values: | Value | Description | | --- | --- | | **`allow`** | Permits only the specified merchants. | | **`block`** | Blocks the specified merchants. |
      - `merchant_ids` string[], required: The list of IDs of merchants to which the control applies. :::tip To find merchant IDs, check transaction details (→ `merchant.id`). You can fetch transaction details for a [specific transaction](https://developer.revolut.com/docs/api/business#get-transaction#response) or for [all transactions](https://developer.revolut.com/docs/api/business#get-transactions#response). :::
    - `mcc_controls` MccControlsSchema: The MCC controls for card spending. They restrict card spending to merchants with the specified [ISO 18245](https://en.wikipedia.org/wiki/ISO_18245) merchant category codes (MCCs). :::tip MCCs are 4-digit codes used by payment card networks to classify businesses by the type of goods or services they provide — for example, `5411` for grocery stores or `7011` for hotels. :::
      - `control_type` 'allow', required: The type of control to apply.
      - `mccs` string[], required: The list of [ISO 18245](https://en.wikipedia.org/wiki/ISO_18245) merchant category codes to which the control applies.
    - `countries` string[]: 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/List_of_ISO_3166_country_codes) codes.
    - `accounts` string[], required: The list of accounts that will be linked to the card.

## Other responses

- `400`: Bad request Returned, for example, when you provide invalid query parameters.
- `401`: Unauthorised Returned, for example, when the credentials you used to make the request are invalid. For more information, see the **Authorization** section.
- `default`: Unexpected error

---

[API](https://skmtc.dev/revolut/apis/business-api.md) - [All operations](https://skmtc.dev/revolut/apis/business-api/llms.txt) - [OpenAPI document](https://skmtc.dev/revolut/apis/business-api/revisions/be089d9fa8b4?raw)