---
title: "Retrieve card invitation details"
method: GET
path: "/card-invitations/{card_invitation_id}"
tags: ["Card invitations"]
---

# Retrieve card invitation details

`GET /card-invitations/{card_invitation_id}`

## Request

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

Get the details of a specific card invitation, based on its ID.

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

## Path parameters

- `card_invitation_id` string, uuid, required

## Response `200`

Information about the card invitation

- CardInvitationResponse
  - `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 an invalid card invitation ID in the path.
- `401`: Unauthorised Returned, for example, when the credentials you used to make the request are invalid. For more information, see the **Authorization** section.
- `404`: Card invitation doesn't exist
- `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)