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

# Update card references

Update the list of [references (`references`)](/docs/api/business#get-card#response) for a [company](/docs/guides/manage-accounts/cards/manage-cards#different-types-of-cards) or [auto-issued card](/docs/guides/manage-accounts/cards/manage-cards#different-types-of-cards).

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

References can be amended up to 10 times.
Reference names must be unique.

References are only supported for cards owned by the business (i.e. [company](/docs/guides/manage-accounts/cards/manage-cards#different-types-of-cards) or [auto-issued cards](/docs/guides/manage-accounts/cards/manage-cards#different-types-of-cards)).
They can't be added to [team member cards](/docs/guides/manage-accounts/cards/manage-cards#different-types-of-cards) (i.e. with `holder_id` present). 

The references recorded on a transaction are those assigned to the card at the time the transaction took place.
If the references are amended, they will only be applied to future transactions.
Existing transaction are not affected.

On success, the updated list of references is returned.

:::warning
This operation **overrides** the existing references.
This means that it removes the current list completely, and replaces it with the new one provided in this request.

If you want to add references to the card instead of replacing the existing ones, make sure that you [fetch](/docs/api/business#get-card) the existing references first, and include them in your request.

To delete existing references without adding new ones, simply provide an empty list.
:::

For more information, see the guides: [Manage cards](/docs/guides/manage-accounts/cards/manage-cards).

## Endpoint

PUT `/cards/{card_id}/references`

## Parameters

### path parameters

- `card_id` (string, required)
  The ID of the card whose references should be amended.

## Request body

References for the card.
Up to 5 name-value pairs assigned to the card for tracking.
:::warning
This will **override** the existing references.
:::

### Attributes

## Returns

### 200

Updated list of references.             
Up to 5 name-value pairs assigned to the card for tracking.

#### Response attributes


## Error responses

| HTTP status code | Description |
| --- | --- |
| 400 | Bad Request  Returned, for example, when you provide duplicate reference names, too many references, the reference names or values are too long, or your request is malformed. |
| 404 | Card not found  The card for which you wish to update references does not exist. |
| 422 | Unprocessable Content  Returned, for example, when you try to amend references more than 10 times, or when you try to add them to a card that does not support references, like a card with a `holder_id` present. |