latestOpenAPI 3.1.0raw.githubusercontent.com2026-08-101025471.3 MB

69be73b5cff0

Card Definitions

Get Card Definition

<Info>

<Badge color="gray">Documentation in progress</Badge>

This documentation is in progress. The parameters, fields, request and response bodies, and other data may be subject to change. If you need more information or you want to share feedback, contact Voucherify support or your Technical Account Manager.

</Info>

Returns a single card definition by its ID.

get/v2/loyalties/card-definitions/{cardDefinitionId}

Path parameters

idstring required

Unique card definition ID. Pattern: ^lcdef_[a-f0-9]+$.

Response

The card definition.

idstring required

Unique card definition ID.

namestring required

Card definition name.

type'INDIVIDUAL' required

Card definition type.

status'DRAFT' | 'ACTIVE' | 'DELETED' required

Current card definition status.

metadataobject required

Arbitrary key-value metadata. Empty object when not set.

created_atstring date-time required

Creation timestamp (ISO 8601).

updated_atstring date-time nullable required

Last update timestamp (ISO 8601). null when the card definition has never been updated.

object'card_definition' required

Object type marker. Always card_definition.