Skip to main content
Permission: Read · Workspace: not required (global) Lists Goody’s greeting cards — the card shown with a gift (distinct from gift-card products). goody_order_batches_create requires a card_id, so call this before composing a gift. Returns up to 25 cards.

Parameters

occasion
string
Optional. Filters to cards tagged with a matching occasion name. The match is case-insensitive but exact — the full name, not a substring. Common values: Birthday, Congratulations, Thank You, Work Anniversary, Welcome, Happy Holidays, Get Well, Thinking of You, Sympathy, Just Because. The vocabulary is data-driven — inspect the occasions array on returned cards to find exact tags.

Returns

cards
object[]
Up to 25 matching cards.

Example

"Show me thank-you cards."
Pass a card_id from here to goody_order_batches_create when composing a gift.