List orders
Orders across all your events, searched by buyer email, name or order ID.
MCP tool billetto_read → list_orders
read
Searches the account-level order list (Manage > Attendees), newest first. query matches the buyer's email address, name or order ID, the three ways Billetto looks an order up. event_id narrows the list to one event. Each row has the order_id, buyer, event and ticket count; get_order returns the tickets.
Parameters
| Name | Type | Description |
|---|---|---|
| query string | string | Buyer email address, buyer name or order ID. |
| event_id string | string | Only orders of this event, from list_events. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "billetto_read",
"arguments": {
"operation": "list_orders",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"orders": [
{
"order_id": "9035127",
"event_id": "1204551",
"event": "Autumn Jazz Night",
"buyer": "Maria Jensen",
"email": "maria.jensen@example.com",
"placed_at": "2026-10-19T18:42:10+02:00",
"tickets": 3
}
],
"next_cursor": null
},
"isError": false
}