show

GET /api/v1/accounts/:account_id/cards/:id

Show a loyalty card

Returns a single loyalty card template by ID, including reward and customer card counts.

Parameters

Name Type Required Description
account_id Must be a Integer Required

Parent store ID

id Must be a Integer Required

Card ID

Error Codes

Code Description
401 Unauthorized – invalid or missing API token
404 Card not found

Returns

Code: 200

A card object

Name Type Required Description
id Must be a Integer Required

Unique card ID

name Must be a String Required

Card name (e.g. ‘Coffee Loyalty Card’)

card_color Must be a String Required

Hex colour for the card background (e.g. ‘#6B4226’)

text_color Must be a String Required

Hex colour for card text

stamp_icon Must be a String Required

Icon used for stamps (e.g. ‘coffee’, ‘heart’, ‘star’)

stamp_color Must be a String Required

Hex colour for stamp icons

stamps_required Must be a Integer Required

Number of stamps needed to complete the card (1–18)

initial_stamps Must be a Integer Required

Number of stamps pre-filled on new customer cards (0 to stamps_required - 1)

strip_type Must be a String Required

Strip image type: ‘color’, ‘image’, or ‘preset’

strip_color Must be a String Required

Hex colour for the strip (when strip_type is ‘color’)

(nil allowed)
strip_preset Must be a String Required

Preset strip image identifier (when strip_type is ‘preset’)

(nil allowed)
header_text Must be a String Required

Optional header text displayed on the card

(nil allowed)
archived_at Must be a String Required

ISO 8601 timestamp when the card was archived, or null if active

(nil allowed)
rewards_count Must be a Integer Required

Number of rewards defined for this card

customer_cards_count Must be a Integer Required

Number of customer card instances issued

created_at Must be a String Required

ISO 8601 creation timestamp

updated_at Must be a String Required

ISO 8601 last-update timestamp