30 days free. No credit card. Full access from the moment you connect your site.

Start free trial

List Orders

tickets/list-orders returns Tickets Commerce orders, newest first, with status, total, currency, gateway name and date.

Purchaser names and emails are withheld unless you ask, and some things are withheld whatever you ask.

At a glance

Abilitytickets/list-orders
ToolsetEvent Tickets — toolset/event-tickets
GroupEvent Tickets › Orders
RequiresEvent Tickets, active on the site
Capabilitymanage_options
SafetyRead-only — changes nothing
RepeatableIdempotent — running it twice leaves the same result
Ships inAcrossAI Abilities Manager 0.0.34 and later

How it works

Raw gateway payloads and processor customer identifiers are never returned. Those are the keys to somebody’s record at Stripe or PayPal, and nothing in a directory listing needs them.

include_personal_data governs names and emails only, and the response counts what it disclosed.

This covers Tickets Commerce. Orders taken through the WooCommerce or EDD providers live in those plugins and are read through their own abilities.

Input

NameTypeRequiredWhat it is
include_personal_databooleanNo — defaults to falseInclude names and email addresses. Off by default, because this data leaves the site when an assistant reads it. The response reports how many records were disclosed.
pageintegerNo — defaults to 11-based page number.
per_pageintegerNo — defaults to 20, max 100Results per page.

What comes back

NameTypeWhat it is
ordersarrayStatus, total, currency, gateway and date per order.
totalintegerHow many orders exist.
disclosedintegerHow many records had personal data returned.
successbooleanWhether the call completed.
messagestringA one-line summary of what happened, suitable for showing a human.
error_codestringPresent only on failure — a stable machine-readable reason, such as a missing field, a wrong field type or an unmet confirmation.

Example

Ask your assistant:

Show me the last twenty ticket orders and their totals.

It resolves to one call:

{
  "ability": "tickets/list-orders",
  "parameters": {
    "per_page": 20
  }
}

Worth knowing

  • Tickets Commerce only. WooCommerce and EDD orders are read through their own plugins.
  • Gateway payloads and processor identifiers are never returned, under any flag.
  • Totals here are what was charged, unlike the estimate in tickets/get-sales-summary.

Related abilities


Get the plugins:
AcrossAI Abilities Manager · AcrossAI MCP Manager

Browse the rest: Every ability, by category


Keep reading