New "Tags" field added to Card Transactions

Overview

Beginning on Wednesday, January 21st, card transactions now include a new tags object, allowing arbitrary key-value metadata to be associated with transactions. This enables custom categorization, internal tracking, and integration with downstream systems. Additional features will be added in the coming weeks allowing tags to be set for transactions- until that time, the field will remain unpopulated.

Details

The tags field is an object containing string key-value pairs.

Abbreviated example transaction response with tags:

{
  "token": "c30c2182-1e69-4e0d-b40f-eec0d2a19123",
  "status": "PENDING",
  "amount": 1800,
  "tags": {
    "risk-level": "high",
    "risk-category": "ATO"
  }
}

Release Timeline

Production availability: January 21, 2026

User Impact

This change is additive only. Existing integrations will continue to function without modification.

Updated Documentation

For complete transaction field specifications, visit our API Reference.

If you have any questions or concerns, please contact us via the HELP link in your Lithic Dashboard.

The Lithic changelog has an RSS feed! To monitor for new update announcements, subscribe with your preferred RSS reader.