---
api: 'Business API'
---

# 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
- 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](/docs/guides/manage-accounts/cards/manage-card-invitations).

## Endpoint

GET `/card-invitations`

## Parameters

### query parameters

- `created_before` (string, optional)
  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](https://en.wikipedia.org/wiki/ISO_8601) format.

- `limit` (number, optional)
  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`.

- `state` (array of enum, optional)
  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.

## Returns

### 200

The list of card invitations for your business

#### Response attributes


## Error responses

| HTTP status code | Description |
| --- | --- |
| 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. |