swarmtix_ticket_types_list
Lists the ticket types an event sells, with price, quantity, remaining availability, per-order limits and sale window
swarmtix_ticket_types_list
Lists the ticket types an event sells, in the order they appear on the event page, one page at a time. A ticket type is the product definition buyers choose from — not a ticket somebody bought.
When you would reach for it
- To see what is on sale and at what price.
- To get a ticket type id for
swarmtix_ticket_types_updateor for scoping a discount inswarmtix_discounts_create. - To check remaining inventory per tier rather than for the event as a whole.
Scope
events:read
This is the event's setup, not its sales, so it sits under events:read rather than orders:read. The available field is a property of the ticket type's inventory, and it comes with the rest of the definition.
Parameters
| Name | Type | Required | Default | Description |
|---|---|---|---|---|
event | string | Yes | — | The event's id (a GUID) or its URL slug. |
limit | integer | No | 50 | How many ticket types to return. 1 to 200. |
cursor | string | No | — | The cursor from the end of a previous page. Omit to start at the beginning. |
Example call
{
"name": "swarmtix_ticket_types_list",
"arguments": { "event": "spring-summit-2026" }
}What comes back
[
{
"id": "b7d3e5a1-92c4-4f18-8a6b-3e0f1c7d9a52",
"eventId": "8f14e45f-ceea-467a-9c3d-1b2a5f6e7d80",
"name": "General Admission",
"description": "Access to all talks and the evening reception.",
"price": 45,
"quantity": 300,
"available": 118,
"minimumPerOrder": 1,
"maximumPerOrder": 10,
"active": true,
"requiresAccessCode": false,
"absorbsFees": true,
"serviceFee": 1.35,
"onSaleFrom": "2026-08-01T09:00:00",
"onSaleUntil": "2026-11-04T19:00:00"
},
{
"id": "f2071a8d-6c39-4b50-93e7-08b5a1d6c4f9",
"eventId": "8f14e45f-ceea-467a-9c3d-1b2a5f6e7d80",
"name": "Workshop Add-on",
"price": 0,
"quantity": 60,
"available": 60,
"minimumPerOrder": 1,
"maximumPerOrder": 2,
"active": true,
"requiresAccessCode": true,
"absorbsFees": false,
"serviceFee": 0,
"onSaleFrom": "2026-08-01T09:00:00",
"onSaleUntil": "2026-11-05T10:00:00"
}
]| Field | What it is |
|---|---|
id | The ticket type's id |
eventId | The event it belongs to |
name | The name buyers see |
description | What the ticket includes, shown under the name |
price | Face price in the event's currency. 0 is a free ticket. |
quantity | How many were put on sale |
available | How many of those are still available |
minimumPerOrder, maximumPerOrder | How many of this ticket one order may contain |
active | Whether the type is switched on |
requiresAccessCode | Whether a buyer needs a code to see or buy it |
absorbsFees | Whether the organiser absorbs the service fee rather than adding it at checkout |
serviceFee | The service fee on one ticket |
onSaleFrom, onSaleUntil | The window during which it can be bought |
Rows come back in the order they appear on the event page, with the id as a tiebreak.
Ticket barcodes and security codes are never returned by this tool or any other. The record behind a ticket type is reused for sold tickets and carries both; neither is named in the projection, and neither may be.
What happens when you call it
- The event identifier is resolved and the ownership checks run.
limitis checked.- The event's ticket types are fetched in one unbounded list, in the standard (non-reserved-seating) form.
- The list is sorted by display order and then by id.
- One page is cut, projected to the fields above, and serialized.
This tool reports the ticket types an ordinary ticketed event sells. An event configured for reserved seating holds its inventory in a seat map as well, and the seating side of it is edited in the dashboard.
Troubleshooting
"Event not found, or this connection does not have access to it."
The event does not exist, or it belongs to a different organisation than this connection covers.
The list is empty on an event you know sells tickets
A freshly created draft has no ticket types until swarmtix_ticket_types_create adds some. If the event is live and the list is still empty, open it in the dashboard — an event using reserved seating keeps its inventory differently.
available does not match what you expect after changing quantity
Changing quantity on an existing ticket type does not change available. They are separate numbers: one is how many were put on sale, the other is how many are left. See swarmtix_ticket_types_update.
"limit is not valid: it was 500. Expected a whole number from 1 to 200, or nothing for 50."
limit must be between 1 and 200.
"This connection is not authorized for events:read. Reconnect and grant it to use this tool."
Reconnect and approve events:read.
Use cases
- "What's still available?" —
availableagainstquantity, per tier - Pricing review before an early-bird tier closes
- Finding a ticket type id to scope a discount to one tier
- Checking a sale window when a buyer says they cannot buy