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

{
  "name": "goody_cards_list",
  "arguments": { "occasion": "Thank You" }
}

{
  "cards": [
    {
      "id": "0f3c…",
      "name": "Heartfelt Thanks",
      "image_url": "https://cards.goody.example/heartfelt-thanks.png",
      "occasions": ["Thank You"]
    },
    {
      "id": "9a17…",
      "name": "Many Thanks",
      "image_url": "https://cards.goody.example/many-thanks.png",
      "occasions": ["Thank You", "Just Because"]
    }
  ]
}
Pass a card_id from here to goody_order_batches_create when composing a gift.