Idempotency for Create Card

Overview

Lithic now supports adding an idempotency key to the header when creating cards. This means that even if there's a connection issue and you have to resend the request you can safely retry requests without inadvertently creating multiple cards.

Details

To make an idempotent request, add the following header: Idempotency-Key: {key}.

An idempotency key is a unique value created by the client that the server uses to identify repeated attempts of the same request. The idempotency key must be a valid UUID (V4 UUIDs are recommended).

curl https://api.lithic.com/v1/cards \
  -H "Authorization: YOUR_API_KEY" \
  -H "Idempotency-Key: 123e4567-e89b-12d3-a456-426614174000" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "VIRTUAL"
  }'

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

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.