Skip to content

REST API v2. Authenticate with a Bearer JWT in the Authorization header unless an endpoint is marked public.

Servers​

https://v2-staging.tscheckout.comCurrent host

GET /orders​

GET
/api/v2/orders

Get orders

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Query Parameters

sort_by

Field to sort by. Default id is system_orders.id (ASC). created is system_orders.created. ticket_id sorts by MAX(system_tickets.id) per order for V1 Order Manager list parity.

Type
string
Valid values
"ticket_id""id""created"
Example"id"
Default
"id"
_include

Include related and additional data. Accepted values: order_total, tickets, purchase_questions, affiliate, promoCodes, purchaseProtected

Type
string
Example"order_total,tickets,purchase_questions,affiliate,promoCodes,purchaseProtected"
order_status

Filter by order status. Accepted values: refunded, partial, checkedIn, purchased, unpaid

Type
string
Example"purchased,checkedIn"
from

Filter orders created from this datetime (format: Y-m-d H:i)

Type
string
Example"2025-11-05 08:19"
to

Filter orders created up to this datetime (format: Y-m-d H:i)

Type
string
Example"2025-11-05 08:25"
event

Filter by a single event ID

Type
integer
Example2
events

Filter by multiple event IDs (comma-separated)

Type
string
Example"1,2"
ticket_type

Filter by ticket type IDs (comma-separated)

Type
string
Example"3,4"
min_ticket_price_paid

Filter by minimum ticket price paid

Type
number
Example100
Format
"float"
max_ticket_price_paid

Filter by maximum ticket price paid

Type
number
Example200
Format
"float"
payment_methods

Filter by payment methods (comma-separated). Accepted values: cash,credit,sezzle

Type
string
Example"cash,credit"
shipping_methods

Filter by shipping method IDs (comma-separated)

Type
string
Example"1,2"
affiliate

Filter by affiliate ID(s) (comma-separated). Ignored when the affiliate filter is locked to the current admin.

Type
string
Example"286,287"
promo_code

Filter by promo code ID(s) (comma-separated)

Type
string
Example"2,3"
promo_code_group

Filter by promo code group name(s) (comma-separated)

Type
string
Example"ICS Promo Code,Summer Sale"
admin_user

Filter by admin user ID(s) (comma-separated)

Type
string
Example"1,2"
purchase_from

Filter by purchase source (comma-separated). Accepted values: boxOffice, boxOfficeV2, frontEnd, backEnd, presale. Selecting boxOffice also matches boxOfficeV2.

Type
string
Example"boxOffice,frontEnd"
change_status

Filter by change status (comma-separated). Accepted value: transferred,eventChange,upgraded,claimed,unclaimed,withdrawn

Type
string
Example"eventChange,upgraded"
order_id

Filter by specific order ID

Type
integer
Example42962
ticket_barcode

Filter by ticket barcode

Type
string
Example"75387482648539"
wave_time

Filter by wave time IDs (comma-separated)

Type
string
Example"1,2,3"
last_4

Filter by last 4 digits of payment card

Type
string
Example"4242"
new_customer

Filter by new customer flag (false = returning, true = new)

Type
string
Valid values
"false""true"
Example"false"
ticket_status

Filter by ticket status. Accepted values: purchased, checkedIn, cancelled, refunded

Type
string
Example"purchased,checkedIn"
purchase_with_pass

Filter orders purchased with a pass (true = yes)

Type
string
Valid values
"false""true"
Example"true"
exclude_free_orders

Hide orders that are currently worth nothing (true = hide). An order with free tickets is still returned while it carries a paid add-on or an upgrade made after checkout.

Type
string
Valid values
"false""true"
Example"true"
from_purchase_date

Filter by ticket purchaseDate >= value (unix timestamp or Y-m-d H:i)

Type
string
Example"1717200000"
to_purchase_date

Filter by ticket purchaseDate < value (exclusive upper bound; unix timestamp or Y-m-d H:i). Matches V1 / export OrderQuery.

Type
string
Example"1717286400"
min_ticket_price

Minimum original ticket price

Type
number
Example10
Format
"float"
max_ticket_price

Maximum original ticket price

Type
number
Example100
Format
"float"
min_current_ticket_price

Minimum current ticket price

Type
number
Example10
Format
"float"
max_current_ticket_price

Maximum current ticket price

Type
number
Example100
Format
"float"
bib_number

Filter by bib number (comma-separated)

Type
string
Example"1001,1002"
purchase_protection

Filter by purchase protection: opted-in, opted-out, or vendor slug

Type
string
Example"opted-in"
event_manager

Filter by event manager admin ID (resolves their event limits)

Type
integer
Example12
updated_from

Filter by ticket lastUpdate >= value (unix timestamp or Y-m-d H:i)

Type
string
Example"1717200000"
updated_to

Filter by ticket lastUpdate < value (exclusive upper bound; unix timestamp or Y-m-d H:i). Matches V1 / export OrderQuery.

Type
string
Example"1717286400"
deleted

Include deleted tickets only (TS users only)

Type
string
Valid values
"false""true"
Example"true"
all_and_delete

Include all tickets including deleted (TS users only)

Type
string
Valid values
"false""true"
Example"true"

Responses​

Order list

application/json
JSON
{
  
"count": 10,
  
"totalCount": 25,
  
"limit": 50,
  
"offset": 25,
  
"data": [
  
]
}

Playground​

Authorization
Variables
Key
Value

Samples​


Get order​

GET
/api/v2/orders/{id}

Get order by Id

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Order Id

Type
integer
Required
Format
"int64"

Query Parameters

_include

Include additional data. Accepted values: order_addons

Type
string
Example"order_addons"

Responses​

Order object

application/json
JSON
{
  
"data": "string"
}

Playground​

Authorization
Variables
Key
Value

Samples​


Update order​

PATCH
/api/v2/orders/{id}

Update order by Id

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Orders Id

Type
integer
Required
Format
"int64"

Request Body​

application/json
JSON
{
  
"data": {
  
  
"shippingMethod": 2,
  
  
"affiliate": 286,
  
  
"customer": {
  
  
  
"id": 5
  
  
},
  
  
"purchaser": {
  
  
  
"firstName": "John",
  
  
  
"lastName": "Doe",
  
  
  
"email": "john@example.com",
  
  
  
"phone": "+112345678000"
  
  
},
  
  
"orderNote": "Note order canceled by admin",
  
  
"purchaseQuestions": [
  
  
  
{
  
  
  
  
"questionId": 1166,
  
  
  
  
"answerId": 414,
  
  
  
  
"answerText": "M ($10.00)",
  
  
  
  
"dynamicQuantity": 0,
  
  
  
  
"displayText": "M ($10.00)",
  
  
  
  
"sku": "123"
  
  
  
}
  
  
],
  
  
"shipping": {
  
  
  
"address": "Address shipping",
  
  
  
"address2": "Address 2 shipping",
  
  
  
"city": "City shipping",
  
  
  
"state": "State shipping",
  
  
  
"country": "Country shipping",
  
  
  
"zip": "Zip shipping"
  
  
},
  
  
"billing": {
  
  
  
"firstName": "Jane billing",
  
  
  
"lastName": "Doe billing",
  
  
  
"address": "Address billing",
  
  
  
"address2": "Address 2 billing",
  
  
  
"city": "City billing",
  
  
  
"state": "State billing",
  
  
  
"country": "Country billing",
  
  
  
"zip": "Zip billing",
  
  
  
"phone": "0622875986 billing"
  
  
},
  
  
"shippingByType": {
  
  
  
"additionalProperties": 0
  
  
},
  
  
"tickets": [
  
  
  
{
  
  
  
  
"id": 1001,
  
  
  
  
"unlocked": 1,
  
  
  
  
"eventId": 0,
  
  
  
  
"typeId": 0,
  
  
  
  
"price": 0,
  
  
  
  
"partyMember": "string",
  
  
  
  
"partyMemberLastName": "string",
  
  
  
  
"emailAddress": "string",
  
  
  
  
"waveTimeId": 0,
  
  
  
  
"teamId": 0,
  
  
  
  
"emergencyContactName": "string",
  
  
  
  
"emergencyContactNumber": "string",
  
  
  
  
"promoCodeUsed": 0,
  
  
  
  
"attendeeQuestions": [
  
  
  
  
  
{
  
  
  
  
  
  
"questionId": 0,
  
  
  
  
  
  
"answerId": 0,
  
  
  
  
  
  
"answerText": "string",
  
  
  
  
  
  
"displayText": "string",
  
  
  
  
  
  
"dynamicQuantity": 0
  
  
  
  
  
}
  
  
  
  
]
  
  
  
}
  
  
]
  
}
}

Responses​

Updated orders object

application/json
JSON
{
  
"data": "string"
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​


Get refundable order payload​

GET
/api/v2/orders/{id}/refundable

Refundable line items and max amounts for the refund UI (V1 getRefundableOrder parity).

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Order Id

Type
integer
Required
Format
"int64"

Responses​

Refundable order payload

application/json
JSON
{
  
"data": "string"
}

Playground​

Authorization
Variables
Key
Value

Samples​


List change orders for an order​

GET
/api/v2/orders/{id}/change-orders

Change-order audit log for an order (v1 Order Manager Change Orders / Change Log parity).

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Order Id

Type
integer
Required
Format
"int64"

Query Parameters

_include

Optional. Default includes ticket-level details. Pass without_tickets to omit tickets[].

Type
string
Example"without_tickets"

Responses​

Change-order log entries

application/json
JSON
{
  
"data": [
  
]
}

Playground​

Authorization
Variables
Key
Value

Samples​


Get order audit timeline​

GET
/api/v2/orders/{id}/timeline

Unified chronological audit timeline for an order (notes, change orders, refunds).

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Order Id

Type
integer
Required
Format
"int64"

Query Parameters

types

Comma-separated entry types to include: note, change_order, refund. Default: all.

Type
string
Example"note,change_order,refund"

Responses​

Timeline entries newest first

application/json
JSON
{
  
"data": [
  
]
}

Playground​

Authorization
Variables
Key
Value

Samples​


Refund order​

POST
/api/v2/orders/{id}/refund

Process a refund for an order. Use GET /orders/{id}/refundable for max refundable amounts.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Order Id

Type
integer
Required
Format
"int64"

Request Body​

application/json
JSON
"string"

Responses​

Refund processed successfully

application/json
JSON
{
  
"message": "Refund processed",
  
"totalRefundAmount": 100,
  
"isCashRefund": false,
  
"skipReason": "string"
}

Playground​

Authorization
Variables
Key
Value
Body

Samples​


Resend order email receipt​

POST
/api/v2/orders/{id}/resend-email

Resend the order receipt via email. Optionally send to all attendees.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Order Id

Type
integer
Required
Format
"int64"

Request Body​

application/json
JSON
"string"

Responses​

Email receipt sent successfully

Playground​

Authorization
Variables
Key
Value
Body

Samples​


Transfer order tickets​

POST
/api/v2/orders/{id}/transfer

Transfer one or more tickets on an order (event/type change or attendee info). Writes change-order audit logs matching V1 Order Manager.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

Order Id

Type
integer
Required
Format
"int64"

Request Body​

application/json
JSON
{
  
"tickets": [
  
  
{
  
  
  
"ticketId": 0,
  
  
  
"eventId": 0,
  
  
  
"typeId": 0,
  
  
  
"price": 0,
  
  
  
"waveTimeId": 0,
  
  
  
"teamId": 0
  
  
}
  
]
}

Responses​

Tickets transferred

Playground​

Authorization
Variables
Key
Value
Body

Samples​


Export orders as CSV​

GET
/api/v2/orders/export/orders

Downloads a CSV file containing order summaries matching the given filters.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Query Parameters

event

Filter by event ID. Supports comma-separated multiple values.

Type
integer
ticketType

Filter by ticket type ID. Supports comma-separated multiple values.

Type
integer
promoCode

Filter by promo code ID. Supports comma-separated multiple values.

Type
integer
affiliate

Filter by affiliate ID. Supports comma-separated multiple values.

Type
integer
paymentMethod

Filter by payment method.

Type
string
purchaseLocation

Filter by purchase location. Supports comma-separated multiple values.

Type
string
orderStatus

Filter by order status (active, cancelled, refunded, partialCancelled, partialRefunded).

Type
string
ticketStatus

Filter by ticket status (purchased, checkedIn, cancelled, refunded).

Type
string
fromPurchaseDate

Earliest purchase date (inclusive).

Type
string
toPurchaseDate

Latest purchase date (exclusive upper bound: purchaseDate < to).

Type
string
fromTicketPrice
Type
number
toTicketPrice
Type
number

Responses​

CSV file download with order summary rows.

text/csv
JSON
"string"

Playground​

Authorization
Variables
Key
Value

Samples​


Export tickets as CSV​

GET
/api/v2/orders/export/tickets

Downloads a CSV file containing one row per ticket with attendee and cost details matching the given filters.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Query Parameters

event

Filter by event ID. Supports comma-separated multiple values.

Type
integer
ticketType

Filter by ticket type ID. Supports comma-separated multiple values.

Type
integer
waveTime

Filter by wave time ID. Supports comma-separated multiple values.

Type
integer
promoCode

Filter by promo code ID. Supports comma-separated multiple values.

Type
integer
affiliate

Filter by affiliate ID. Supports comma-separated multiple values.

Type
integer
paymentMethod
Type
string
orderStatus
Type
string
ticketStatus
Type
string
bibNumber

Filter by bib number. Supports comma-separated multiple values.

Type
string
fromPurchaseDate
Type
string
toPurchaseDate
Type
string

Responses​

CSV file download with one row per ticket.

text/csv
JSON
"string"

Playground​

Authorization
Variables
Key
Value

Samples​


Export purchasers as CSV​

GET
/api/v2/orders/export/purchasers

Downloads a CSV file containing purchaser name, email, and order ID for each matching order.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Query Parameters

event
Type
integer
ticketType
Type
integer
orderStatus
Type
string
ticketStatus
Type
string
fromPurchaseDate
Type
string
toPurchaseDate
Type
string

Responses​

CSV file download with purchaser rows.

text/csv
JSON
"string"

Playground​

Authorization
Variables
Key
Value

Samples​


Export attendees as CSV​

GET
/api/v2/orders/export/attendees

Downloads a CSV file containing attendee name, email, and order ID for each ticket in matching orders.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Query Parameters

event
Type
integer
ticketType
Type
integer
orderStatus
Type
string
ticketStatus
Type
string
fromPurchaseDate
Type
string
toPurchaseDate
Type
string

Responses​

CSV file download with one row per attendee.

text/csv
JSON
"string"

Playground​

Authorization
Variables
Key
Value

Samples​


Export shipping details as CSV​

GET
/api/v2/orders/export/shipping

Downloads a CSV file containing shipping address information for each ticket in matching orders.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Query Parameters

event
Type
integer
ticketType
Type
integer
shippingMethod

Filter by shipping method ID.

Type
integer
orderStatus
Type
string
ticketStatus
Type
string
fromPurchaseDate
Type
string
toPurchaseDate
Type
string

Responses​

CSV file download with shipping address rows.

text/csv
JSON
"string"

Playground​

Authorization
Variables
Key
Value

Samples​


Returns a single order​

GET
/api/v2/order/{id}

Returns a single order

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

The id of the order

Type
string
Required

Query Parameters

includeTickets

Set to true to include the ticket details.

Type
boolean
includeAnswers

Include any answer's for both the orders and tickets.

Type
boolean
includeCosts

Include costs as part of the order.

Type
boolean

Responses​

The order was found.

application/json
JSON
{
  
"id": "string",
  
"created": "string",
  
"purchasedDate": "string",
  
"status": "string",
  
"emailAddress": "string",
  
"total": 0,
  
"purchaser": "string",
  
"newCustomer": 0,
  
"affiliate": "string",
  
"paymentMethod": "string",
  
"lastFour": "string",
  
"tickets": [
  
  
{
  
  
  
"id": "string",
  
  
  
"status": "active",
  
  
  
"price": 0,
  
  
  
"attendee": 0,
  
  
  
"name": "string",
  
  
  
"attendeeAddress": "string",
  
  
  
"answers": [
  
  
  
  
{
  
  
  
  
  
"question": "string",
  
  
  
  
  
"answer": "string"
  
  
  
  
}
  
  
  
]
  
  
}
  
],
  
"transactions": [
  
  
{
  
  
  
"timestamp": "string",
  
  
  
"type": "string",
  
  
  
"amount": 0
  
  
}
  
],
  
"answers": [
  
]
}

Playground​

Authorization
Variables
Key
Value

Samples​


Retrieves a list of orders.​

GET
/api/v2/order

Returns a list of order summaries. Note that filters apply to the orders, not the ticket. If you filter by an event and order has tickets for the filtered event and another both tickets will be returned.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Query Parameters

_limit

Set the max number of objects to return.

Type
number
Format
"integer"
_offset

Set the number of objects to ignore before starting.

Type
number
Format
"integer"
search

Searchs purchaser's first name, last name, email address as well as the ticket's barcode and order #.

Type
string
purchaseLocation

The location the order was purchased. Supports multiple values seperated by a comma.

Type
string
ticketType

The id of the ticket types that where purchased. Supports multiple values seperated by a comma.

Type
integer
adminUser

The id of the user who sold the ticket. Supports multiple values seperated by a comma.

Type
integer
event

The id of the event tickets where purchased for. Supports multiple values seperated by a comma.

Type
integer
waveTime

The id of the wave time purchase. Supports multiple values seperated by a comma.

Type
integer
creditCardNumber

The last four of the CC used to pay for the order. Supports multiple values seperated by a comma.

Type
string
bibNumber

Only include orders with a ticket that matches the bib number. Supports multiple values seperated by a comma.

Type
string
paymentMethod

The payment method used to purchase the order.

Type
string
promoCode

The id's of the promo code that was applied to the order. Supports multiple values seperated by a comma.

Type
integer
promoCodeGroup

The names's of the promo code group that was applied to the order. Supports multiple values seperated by a comma.

Type
string
orderStatus

Filter by the order's status. Acceptable values are active, cancelled, refunded, paritalCancelled, or partialRefunded.

Type
string
changeStatus

Filter by the order change status. Acceptable values are transferred, upgraded, claimed, unclaimed, withdrawn, or eventChange.

Type
string
ticketStatus

Filter by the ticket's status. Acceptable values are purchased, checkedIn, cancelled, or refunded.

Type
string
affiliate

The id of affilate associated with the order. Supports multiple values seperated by a comma.

Type
integer
shippingMethod

Filter by the shipping method id.

Type
number
purchasedWithPass

Pass true to limit search for to orders that were purchased with a pass.

Type
bool
excludeFreeOrders

Pass true to hide orders that are currently worth nothing. An order with free tickets is still returned while it carries a paid add-on or an upgrade made after checkout.

Type
bool
newCustomer

Filter by whether the purchaser was a new customer (1) or a returning customer (0) at the time of order creation.

Type
string
Valid values
"0""1"
purchaseProtection

Filters based on if purchase protection was purchased. Supports opted-in, opted-out, or a vendor slug.

Type
string
fromPurchaseDate

The earliest date the order was purchased (unix timestamp).

Type
integer
toPurchaseDate

The latest date the order was purchased (unix timestamp).

Type
integer
updatedFrom

The earliest ticket lastUpdate (unix timestamp).

Type
integer
updatedTo

The latest ticket lastUpdate (unix timestamp).

Type
integer
fromTicketPrice

The lowest listed price for a ticket when purchased.

Type
number
toTicketPrice

The highest lised price for a ticket when purchased.

Type
number
fromCurrentTicketPrice

The lowest price currently paid for a ticket.

Type
number
toCurrentTicketPrice

The highest price currently paid for a ticket.

Type
number
fromTicketPricePaid

The lowest price originally paid for a ticket.

Type
number
toTicketPricePaid

The highest price originally paid for a ticket.

Type
number
return

Select the format of the returned data. If the parameter is not provided the default format is standard. Can be one of the following:

  • attendees - A csv containing the list of matching attendees.
  • purchasers - A csv containing the list of matching purchasers.
  • tickets - A csv containing the list of matching tickets.
  • orders - A csv contain the list of matching orders.
  • shipping - A csv contain shipping information for the matching orders.
  • standard - Json contain the selected data.
Type
string
_include

Adds additional details to the results. Ignored if format is any other then standard. Multiple options can be include seperated by a comma. Supports the following values:

  • answers - Include answers to questions.
  • tickets - Include ticket information.
  • promoCodes - Include promo codes used.
  • hash - Include order hash.
  • costs - Include cost information.
  • purchaseProtected - Include purchase protect information.
  • allTicketsForOrder - Include all tickets for order ignoring fileters.
  • ticketCount - Include the number of tickets per order.
  • change - Include orders id of new/old orders.
  • promoter - Include the ticket's promoter.
  • waveTime - Include the wave time id (if any).
  • waivers - Includes signed waivers attached to the ticket (if any).
  • user - Include user information.
Type
string

Responses​

A list of matching orders.

Playground​

Authorization
Variables
Key
Value

Samples​


Creates an order once payment has been verified.​

POST
/api/v2/order

Creates an order based on the cart created via the shopping cart end points. The order is only created after payment has been verified.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Request Body​

application/json
JSON
{
  
"order": "string"
}

Responses​

The order was created after payment was successfully. The order is only included if result is order.

application/json
JSON
{
  
"id": "string",
  
"order": "string"
}

Playground​

Authorization
Body

Samples​


Scan all tickets in an order.​

POST
/api/v2/order/{id}/scan

Scans all tickets in an order.

Authorizations​

bearerAuth
Type
HTTP (bearer)

Parameters​

Path Parameters

id*

The id of the order.

Type
string
Required

Request Body​

application/json
JSON
{
  
"tickets": [
  
  
{
  
  
  
"ticketId": "string",
  
  
  
"bibNumber": "string",
  
  
  
"chipNumber": "string"
  
  
}
  
]
}

Responses​

The order was successfully scanned.

Playground​

Authorization
Variables
Key
Value
Body

Samples​


Process the cart data to describe what order would be created with it​

POST
/api/v2/order/describe

Process the cart data to describe what order would be created with it

Authorizations​

bearerAuth
Type
HTTP (bearer)

Request Body​

application/json
JSON
"string"

Responses​

Playground​

Authorization
Body

Samples​


Complete a staged order and run the after order processes​

POST
/api/v2/order/complete

Complete a staged order and run the after order processes

Authorizations​

bearerAuth
Type
HTTP (bearer)

Request Body​

application/json
JSON
{
  
"orderId": 0,
  
"orderGuid": 0
}

Responses​

Playground​

Authorization
Body

Samples​


Powered by VitePress OpenAPI