Cards

Update card references

Update the list of references (references) for a company or auto-issued card.

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

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 or auto-issued cards). They can't be added to team member 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 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.

put/cards/{card_id}/references

Request

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

Path parameters

card_idstring uuid required

The ID of the card whose references should be amended.

Request body

namestring required

The name of the card reference. Must be unique.

valuestring required

The value for this reference.

Example request

[
  {
    "name": "PNR",
    "value": "RT12345"
  },
  {
    "name": "Traveller",
    "value": "John Smith"
  }
]

Response

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