Ticket Tailor
App · 20 actions
Manage your Ticket Tailor box office: create and change event series with their dates and ticket types, read orders, issued tickets and check-ins, and create discount codes.
Actions
| Action | What it does |
|---|---|
| Add event date | Add a dated event to an event series. |
| Create discount code | Create a discount code buyers can use at checkout, taking a percentage or a fixed amount off each ticket. |
| Create event series | Create an event series as a draft. |
| Create ticket type | Add a ticket type to an event series, with its price and how many are for sale. |
| Delete discount code | Delete a discount code. |
| Delete event series | Delete an event series and all its dates. |
| Delete ticket type | Delete a ticket type from an event series. |
| Get box office overview | Get your box office's name, currency, credits, number of events and orders, tickets issued and revenue. |
| Get event | Get one dated event with its start and end, venue, status and ticket types. |
| Get event series | Get one event series with its venue, status, time zone and default ticket types. |
| Get issued ticket | Get one issued ticket with its attendee, barcode, price and whether it was checked in. |
| Get order | Get one order with its buyer, tickets, amounts and payment details. |
| List check-ins | List ticket check-ins, filtered by event, series, ticket or check-in date. |
| List discount codes | List discount codes, or look one up by its code. |
| List event dates | List the dated events of one event series, optionally only those starting within a date range. |
| List event series | List event series (an event and all its dates), filtered by status, name or venue. |
| List events | List dated events across all series, filtered by status, name, venue or start date. |
| List issued tickets | List tickets that have been issued, filtered by status, attendee, barcode, order or event. |
| List orders | List orders, filtered by status, buyer, event or the date placed. |
| Update event series | Change an event series' name, description, venue or button text. |
Add event date
Add a dated event to an event series. The start and end are converted to the series' own time zone.
Inputs
- Event series
event_series_idtextRequired - The event series. Pick one, or give its id from an earlier step.
- Start
start_atdate and timeRequired - When the event starts. Shown in the series' own time zone.
- End
end_atdate and timeRequired - When the event ends. It must be after the start.
Outputs
eventobject- The new dated event
Example output
{
"event": {
"checkout_url": "https://buytickets.at/example/1001/ev_1001",
"currency": "gbp",
"end_at": "2026-11-20T22:00:00+00:00",
"event_series_id": "es_1001",
"hidden": false,
"id": "ev_1001",
"name": "Autumn Gala",
"online": false,
"online_link": "",
"revenue": 0,
"start_at": "2026-11-20T19:00:00+00:00",
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
}Create discount code
Create a discount code buyers can use at checkout, taking a percentage or a fixed amount off each ticket.
Inputs
- Name
nametextRequired - A name for your own reference.
- Code
codetextRequired - What buyers type at checkout: letters, digits, '_' and '-'.
- Type
discount_typetextRequired - Take a percentage or a fixed amount off.One of:
percentage(Percentage off),fixed_amount(Fixed amount off). - Amount
amountnumberRequired - A whole percentage from 1 to 100, or for a fixed amount the money off each ticket, such as 5.00.At least 0.
- Times it can be used
max_redemptionsnumber - Stop accepting the code after this many uses. Blank is no limit.At least 1.
- Expires
expiresdate and time - When the code stops working. Blank is never.
Outputs
discountobject- The new discount code
Example output
{
"discount": {
"amount_off": 0,
"code": "FRIENDS10",
"expires_at": "2026-12-31T23:59:59+00:00",
"id": "dc_1001",
"max_redemptions": 50,
"name": "Friends",
"percent_off": 10,
"times_redeemed": 0,
"type": "percentage"
}
}Create event series
Create an event series as a draft. Add dates and ticket types to it, then publish it in Ticket Tailor.
Inputs
- Event name
nametextRequired - The name of the event series. It is created as a draft.
- Description
descriptiontext - What the event is about.
- Venue
venuetext - The venue's name.
- Postal code
postal_codetext - The venue's postal code.
- Country code
countrytext - The venue's two-letter country code, such as GB or US.
- Currency
currencytext - The currency tickets are sold in. Defaults to your box office's.One of:
gbp,usd,eur,aud,brl,cad,czk,dkk,hkd,huf, and 86 more.
Outputs
event_seriesobject- The new event series, as a draft
Example output
{
"event_series": {
"call_to_action": "Book now",
"created_at": "2026-10-01T09:00:00+00:00",
"currency": "gbp",
"description": "A night out.",
"id": "es_1001",
"name": "Autumn Gala",
"next_occurrence_at": "2026-11-20T19:00:00+00:00",
"revenue": 0,
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"timezone": "Europe/London",
"total_issued_tickets": 0,
"total_occurrences": 1,
"url": "https://buytickets.at/example/1001",
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
}Create ticket type
Add a ticket type to an event series, with its price and how many are for sale. A price of 0 makes it free.
Inputs
- Event series
event_series_idtextRequired - The event series. Pick one, or give its id from an earlier step.
- Ticket name
nametextRequired - What buyers see, such as 'General admission'.
- Price
pricenumberRequired - The price in the series' currency, such as 12.50. Use 0 for a free ticket.At least 0.
- Quantity
quantitynumberRequired - How many tickets of this type are for sale.At least 1.
- Description
descriptiontext - Extra detail shown under the ticket name.
- Availability
statustext - Whether buyers can see and buy it. Defaults to on sale.One of:
ON_SALE(On sale (default)),HIDDEN,UNAVAILABLE,SOLD_OUT(Sold out),ADMIN_ONLY(Box office only),LOCKED(Locked behind an access code). - Minimum per order
min_per_ordernumber - The fewest a buyer can order.At least 1.
- Maximum per order
max_per_ordernumber - The most a buyer can order.At least 1.
Outputs
ticket_typeobject- The new ticket type
Example output
{
"ticket_type": {
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
}Delete discount code
Delete a discount code. This cannot be undone.
Inputs
- Discount code ID
discount_idtextRequired - The id of the discount code, from 'List discount codes' or 'Create discount code'.
Outputs
deletedtrue/false- Always true once deleted
idtext- The id of the discount code deleted
Example output
{
"deleted": true,
"id": "dc_1001"
}Delete event series
Delete an event series and all its dates. This cannot be undone.
Inputs
- Event series
event_series_idtextRequired - The event series. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
idtext- The id of the event series deleted
Example output
{
"deleted": true,
"id": "es_1001"
}Delete ticket type
Delete a ticket type from an event series. This cannot be undone.
Inputs
- Event series
event_series_idtextRequired - The event series. Pick one, or give its id from an earlier step.
- Ticket type
ticket_type_idtextRequired - The ticket type. Pick one, or give its id from an earlier step.
Outputs
deletedtrue/false- Always true once deleted
idtext- The id of the ticket type deleted
Example output
{
"deleted": true,
"id": "tt_1001"
}Get box office overview
Get your box office's name, currency, credits, number of events and orders, tickets issued and revenue.
Inputs
None.
Outputs
overviewobject- The box office statistics
Example output
{
"overview": {
"box_office_name": "Example Events",
"credits": 0,
"currency": "gbp",
"event_occurrences_draft": 1,
"event_occurrences_published": 3,
"event_series_draft": 1,
"event_series_published": 2,
"orders_received": 40,
"revenue": 125000,
"total_issued_tickets": 85,
"waitlist_signups": 0
}
}Get event
Get one dated event with its start and end, venue, status and ticket types.
Inputs
- Event ID
event_idtextRequired - The id of a dated event, from 'List events' or an earlier step.
Outputs
eventobject- The event
Example output
{
"event": {
"checkout_url": "https://buytickets.at/example/1001/ev_1001",
"currency": "gbp",
"end_at": "2026-11-20T22:00:00+00:00",
"event_series_id": "es_1001",
"hidden": false,
"id": "ev_1001",
"name": "Autumn Gala",
"online": false,
"online_link": "",
"revenue": 0,
"start_at": "2026-11-20T19:00:00+00:00",
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
}Get event series
Get one event series with its venue, status, time zone and default ticket types.
Inputs
- Event series
event_series_idtextRequired - The event series. Pick one, or give its id from an earlier step.
Outputs
event_seriesobject- The event series
Example output
{
"event_series": {
"call_to_action": "Book now",
"created_at": "2026-10-01T09:00:00+00:00",
"currency": "gbp",
"description": "A night out.",
"id": "es_1001",
"name": "Autumn Gala",
"next_occurrence_at": "2026-11-20T19:00:00+00:00",
"revenue": 0,
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"timezone": "Europe/London",
"total_issued_tickets": 0,
"total_occurrences": 1,
"url": "https://buytickets.at/example/1001",
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
}Get issued ticket
Get one issued ticket with its attendee, barcode, price and whether it was checked in.
Inputs
- Issued ticket ID
issued_ticket_idtextRequired - The ticket's id, from 'List issued tickets' or an earlier step.
Outputs
issued_ticketobject- The ticket
Example output
{
"issued_ticket": {
"barcode": "TT1001",
"checked_in": false,
"created_at": "2026-10-20T10:00:00+00:00",
"description": "General admission",
"email": "jo@example.com",
"event_id": "ev_1001",
"event_series_id": "es_1001",
"full_name": "Jo Bloggs",
"id": "it_1001",
"order_id": "or_1001",
"price": 1250,
"reference": "",
"status": "valid",
"ticket_type_id": "tt_1001"
}
}Get order
Get one order with its buyer, tickets, amounts and payment details.
Inputs
- Order ID
order_idtextRequired - The order's id, from 'List orders' or an earlier step.
Outputs
orderobject- The order
Example output
{
"order": {
"buyer_email": "jo@example.com",
"buyer_first_name": "Jo",
"buyer_last_name": "Bloggs",
"buyer_name": "Jo Bloggs",
"buyer_phone": "",
"created_at": "2026-10-20T10:00:00+00:00",
"currency": "gbp",
"event_id": "ev_1001",
"event_name": "Autumn Gala",
"event_series_id": "es_1001",
"id": "or_1001",
"issued_tickets": [
{
"barcode": "TT1001",
"checked_in": false,
"created_at": "2026-10-20T10:00:00+00:00",
"description": "General admission",
"email": "jo@example.com",
"event_id": "ev_1001",
"event_series_id": "es_1001",
"full_name": "Jo Bloggs",
"id": "it_1001",
"order_id": "or_1001",
"price": 1250,
"reference": "",
"status": "valid",
"ticket_type_id": "tt_1001"
}
],
"notes": "",
"refund_amount": 0,
"status": "completed",
"subtotal": 1250,
"tax": 0,
"ticket_count": 1,
"total": 1250,
"total_paid": 1250,
"txn_id": "tx_1001"
}
}List check-ins
List ticket check-ins, filtered by event, series, ticket or check-in date. Returns up to 100.
Inputs
- Event ID
event_idtext - Only records of this dated event.
- Event series
event_series_idtext - Only records of this event series.
- Issued ticket ID
issued_ticket_idtext - Only check-ins of this ticket.
- Checked in from
from_datedate - Only check-ins on or after this date (UTC).
- Checked in until
until_datedate - Only check-ins on or before this date (UTC).
- Page size
limitnumber - How many to return, 1 to 100.From 1 to 100.
Outputs
check_inslist- The check-ins
countnumber- How many are on this page
has_moretrue/false- Whether Ticket Tailor has more
next_cursortext- Always empty: this list returns one page of up to 100
Example output
{
"check_ins": [
{
"checked_in_at": "2026-11-20T18:45:00+00:00",
"created_at": "2026-11-20T18:45:00+00:00",
"event_id": "ev_1001",
"id": "ci_1001",
"issued_ticket_id": "it_1001",
"quantity": 1
}
],
"count": 1,
"has_more": false,
"next_cursor": ""
}List discount codes
List discount codes, or look one up by its code. Returns up to 100.
Inputs
- Code
codetext - Only the discount code that reads exactly this.
- Page size
limitnumber - How many to return, 1 to 100.From 1 to 100.
Outputs
countnumber- How many are on this page
discountslist- The discount codes
has_moretrue/false- Whether Ticket Tailor has more
next_cursortext- Always empty: this list returns one page of up to 100
Example output
{
"count": 1,
"discounts": [
{
"amount_off": 0,
"code": "FRIENDS10",
"expires_at": "2026-12-31T23:59:59+00:00",
"id": "dc_1001",
"max_redemptions": 50,
"name": "Friends",
"percent_off": 10,
"times_redeemed": 0,
"type": "percentage"
}
],
"has_more": false,
"next_cursor": ""
}List event dates
List the dated events of one event series, optionally only those starting within a date range.
Inputs
- Event series
event_series_idtextRequired - The event series. Pick one, or give its id from an earlier step.
- From date
from_datedate - Only records on or after this date (UTC).
- Until date
until_datedate - Only records on or before this date (UTC).
- Page size
limitnumber - How many to return, 1 to 100.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
eventslist- The dated events
has_moretrue/false- Whether Ticket Tailor has more
next_cursortext- Pass as 'Next page cursor' for the next page; empty when there is none
Example output
{
"count": 1,
"events": [
{
"checkout_url": "https://buytickets.at/example/1001/ev_1001",
"currency": "gbp",
"end_at": "2026-11-20T22:00:00+00:00",
"event_series_id": "es_1001",
"hidden": false,
"id": "ev_1001",
"name": "Autumn Gala",
"online": false,
"online_link": "",
"revenue": 0,
"start_at": "2026-11-20T19:00:00+00:00",
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
],
"has_more": false,
"next_cursor": ""
}List event series
List event series (an event and all its dates), filtered by status, name or venue. Returns up to 100.
Inputs
- Status
statustext - Only event series with this status.One of:
published,draft,sales_closed(Sales closed). - Name
nametext - Only event series with this name.
- Venue
venuetext - Only event series at this venue.
- Page size
limitnumber - How many to return, 1 to 100.From 1 to 100.
Outputs
countnumber- How many are on this page
event_serieslist- The event series
has_moretrue/false- Whether Ticket Tailor has more
next_cursortext- Always empty: this list returns one page of up to 100
Example output
{
"count": 1,
"event_series": [
{
"call_to_action": "Book now",
"created_at": "2026-10-01T09:00:00+00:00",
"currency": "gbp",
"description": "A night out.",
"id": "es_1001",
"name": "Autumn Gala",
"next_occurrence_at": "2026-11-20T19:00:00+00:00",
"revenue": 0,
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"timezone": "Europe/London",
"total_issued_tickets": 0,
"total_occurrences": 1,
"url": "https://buytickets.at/example/1001",
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
],
"has_more": false,
"next_cursor": ""
}List events
List dated events across all series, filtered by status, name, venue or start date. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Status
statustext - Only events with this status.One of:
published,draft,sales_closed(Sales closed). - Name contains
nametext - Only events with this name.
- Venue
venuetext - Only events at this venue.
- From date
from_datedate - Only records on or after this date (UTC).
- Until date
until_datedate - Only records on or before this date (UTC).
- Page size
limitnumber - How many to return, 1 to 100.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
eventslist- The events
has_moretrue/false- Whether Ticket Tailor has more
next_cursortext- Pass as 'Next page cursor' for the next page; empty when there is none
Example output
{
"count": 1,
"events": [
{
"checkout_url": "https://buytickets.at/example/1001/ev_1001",
"currency": "gbp",
"end_at": "2026-11-20T22:00:00+00:00",
"event_series_id": "es_1001",
"hidden": false,
"id": "ev_1001",
"name": "Autumn Gala",
"online": false,
"online_link": "",
"revenue": 0,
"start_at": "2026-11-20T19:00:00+00:00",
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
],
"has_more": false,
"next_cursor": ""
}List issued tickets
List tickets that have been issued, filtered by status, attendee, barcode, order or event. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Status
statustext - Only tickets with this status.One of:
valid,voided. - Attendee email
emailtext - Only tickets issued to this email address.
- Attendee name
nametext - Only tickets issued to this name.
- Barcode
barcodetext - Only the ticket with this barcode.
- Order ID
order_idtext - Only tickets of this order.
- Event ID
event_idtext - Only records of this dated event.
- Event series
event_series_idtext - Only records of this event series.
- Page size
limitnumber - How many to return, 1 to 100.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether Ticket Tailor has more
issued_ticketslist- The tickets
next_cursortext- Pass as 'Next page cursor' for the next page; empty when there is none
Example output
{
"count": 1,
"has_more": false,
"issued_tickets": [
{
"barcode": "TT1001",
"checked_in": false,
"created_at": "2026-10-20T10:00:00+00:00",
"description": "General admission",
"email": "jo@example.com",
"event_id": "ev_1001",
"event_series_id": "es_1001",
"full_name": "Jo Bloggs",
"id": "it_1001",
"order_id": "or_1001",
"price": 1250,
"reference": "",
"status": "valid",
"ticket_type_id": "tt_1001"
}
],
"next_cursor": ""
}List orders
List orders, filtered by status, buyer, event or the date placed. Gets one page; to see more, run it again with the next page it gives.
Inputs
- Status
statustext - Only orders with this status.One of:
completed,pending,canceled. - Buyer email
emailtext - Only orders placed with this email address.
- Buyer name
nametext - Only orders whose buyer has this first, last or full name.
- Event ID
event_idtext - Only records of this dated event.
- Event series
event_series_idtext - Only records of this event series.
- Placed from
from_datedate - Only orders placed on or after this date (UTC).
- Placed until
until_datedate - Only orders placed on or before this date (UTC).
- Page size
limitnumber - How many to return, 1 to 100.From 1 to 100.
- Next page cursor
aftertext - The 'next_cursor' from an earlier page, to get the page after it.
Outputs
countnumber- How many are on this page
has_moretrue/false- Whether Ticket Tailor has more
next_cursortext- Pass as 'Next page cursor' for the next page; empty when there is none
orderslist- The orders
Example output
{
"count": 1,
"has_more": false,
"next_cursor": "",
"orders": [
{
"buyer_email": "jo@example.com",
"buyer_first_name": "Jo",
"buyer_last_name": "Bloggs",
"buyer_name": "Jo Bloggs",
"buyer_phone": "",
"created_at": "2026-10-20T10:00:00+00:00",
"currency": "gbp",
"event_id": "ev_1001",
"event_name": "Autumn Gala",
"event_series_id": "es_1001",
"id": "or_1001",
"issued_tickets": [
{
"barcode": "TT1001",
"checked_in": false,
"created_at": "2026-10-20T10:00:00+00:00",
"description": "General admission",
"email": "jo@example.com",
"event_id": "ev_1001",
"event_series_id": "es_1001",
"full_name": "Jo Bloggs",
"id": "it_1001",
"order_id": "or_1001",
"price": 1250,
"reference": "",
"status": "valid",
"ticket_type_id": "tt_1001"
}
],
"notes": "",
"refund_amount": 0,
"status": "completed",
"subtotal": 1250,
"tax": 0,
"ticket_count": 1,
"total": 1250,
"total_paid": 1250,
"txn_id": "tx_1001"
}
]
}Update event series
Change an event series' name, description, venue or button text. Fields left blank are kept.
Inputs
- Event series
event_series_idtextRequired - The event series. Pick one, or give its id from an earlier step.
- Event name
nametext - A new name. Leave blank to keep the current one.
- Description
descriptiontext - What the event is about.
- Venue
venuetext - The venue's name.
- Postal code
postal_codetext - The venue's postal code.
- Country code
countrytext - The venue's two-letter country code, such as GB or US.
- Button text
call_to_actiontext - The text on the event page's buy button, such as 'Book now'.
Outputs
event_seriesobject- The updated series
Example output
{
"event_series": {
"call_to_action": "Book now",
"created_at": "2026-10-01T09:00:00+00:00",
"currency": "gbp",
"description": "A night out.",
"id": "es_1001",
"name": "Autumn Gala",
"next_occurrence_at": "2026-11-20T19:00:00+00:00",
"revenue": 0,
"status": "draft",
"ticket_types": [
{
"description": "",
"id": "tt_1001",
"max_per_order": 10,
"min_per_order": 1,
"name": "General admission",
"price": 1250,
"quantity_issued": 0,
"quantity_remaining": 100,
"quantity_total": 100,
"status": "on_sale",
"type": "paid"
}
],
"timezone": "Europe/London",
"total_issued_tickets": 0,
"total_occurrences": 1,
"url": "https://buytickets.at/example/1001",
"venue_country": "GB",
"venue_name": "Town Hall",
"venue_postal_code": "AB1 2CD"
}
}