Update card references

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

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

note

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.

caution

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.

On success, the updated list of references is returned.

note

This feature is available in the UK, US, the EEA, and SG.

This feature is not available in Sandbox.

To use the Cards API, please contact Revolut API Support.

For more information, see the guides: Manage cards.

Request

References for the card. Up to 5 name-value pairs assigned to the card for tracking.

caution

This will override the existing references.

Path Parameters
Path Parameters

The ID of the card whose references should be amended.

Request body
Body array of objects

Possible length: non-empty and <= 30 characters

The name of the card reference. Must be unique.

Possible length: non-empty and <= 30 characters

The value for this reference.

Response

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

Response body
Body array of objects

Possible length: non-empty and <= 30 characters

The name of the card reference. Must be unique.

Possible length: non-empty and <= 30 characters

The value for this reference.

Was this page helpful?