Skip to main content
Permission: Read · Workspace: required (from goody_workspaces_list) Lists previously-sent gift batches in a workspace, most recent first. This is how you answer “what did I send recently?”.

​
Parameters

​
workspace_id
string
required
Workspace UUID — from goody_workspaces_list. Listing is always scoped to this workspace.
​
page
integer
default:"1"
Page number, starting at 1.
​
per_page
integer
default:"25"
Batches per page. Defaults to 25, max 100.

​
Returns

​
order_batches
object[]
Batch summaries, most recent first. Each object also includes additional summary fields beyond those listed here.
​
total_count
integer
Total number of batches across all pages.

​
Example

"Show me my last few gifts."

{
  "name": "goody_order_batches_list",
  "arguments": { "workspace_id": "3f8a…", "per_page": 3 }
}

{
  "order_batches": [
    {
      "id": "b92e…",
      "batch_name": "Q2 client thank-yous",
      "send_status": "sent",
      "from_name": "Jordan at Acme",
      "message": "Thank you for a great quarter, {{firstname}}!",
      "orders_count": 12,
      "recipients_count": 12,
      "scheduled_send_on": null
    },
    {
      "id": "4a07…",
      "batch_name": "Welcome — new hires",
      "send_status": "scheduled",
      "from_name": "The Acme Team",
      "message": "Welcome aboard, {{firstname}}!",
      "orders_count": 3,
      "recipients_count": 3,
      "scheduled_send_on": "2026-07-01T09:00:00Z"
    }
  ],
  "total_count": 47
}
For the full detail of one batch use goody_order_batches_get; to list the individual orders inside a batch use goody_orders_list.