API Documentation
Overview
Our Exchange API is organized around REST. Our API has predictable resource-oriented URLs, accepts JSON request bodies, returns JSON-encoded responses, and uses standard HTTP response codes and verbs.
Authentication
Authentication is based on API Tokens plus a shared secret which is used to compute a required X-Signature header.
Credential Type | Description | Required Headers |
---|---|---|
Upload Credential | Used only to upload inventory either via the Auto Uploader software or via a special API endpoint. |
|
API Credential | The typical credential which acts on behalf of a Brokerage. |
|
User Credential | A User Credential is used to act on behalf of a specific User and is need for certain endpoints. |
|
Environments
There are two distinct environments available for the API. The Production environment is the one your production applications should use, but a Sandbox environment is also provided for testing your integrations. The Sandbox is an environment completely isolated from Production, but has the same Events, Performers, Venues, and Configurations as the Production environment.
Environment | API URL |
---|---|
Sandbox | https://api.sandbox.ticketevolution.com |
Production | https://api.ticketevolution.com |
For more information on placing test orders in Sandbox see Placing Test Orders.
Pagination
Most endpoints support Pagination which allows you to adjust the quantity and range of results returned. The following query parameters will let you change the result set size for list endpoints and access additional pages.
per_page
- defaults to 100, maximum of 100page
- defaults to 1
Conditionals
Most endpoints that accept date parameters such as updated_at
or occurs_at
support the following conditionals for creating a date range. The deleted endpoints utilize deleted_at
.
.eq
- equal (case-sensitive).not_eq
- not equal (case-sensitive).gt
- greater than.gte
- greater than or equal.lt
- less than.lte
- less than or equal
For example, this query would find all of the events occurring between May 15 and May 20, 2023:
/v9/events?occurs_at.gte=2023-05-15&occurs_at.lt=2023-05-20
Mailing List
Our low-volume mailing list for developers who are integrating with the Exchange API will keep you informed of changes, additions, and improvements to our APIs. Sign up at http://eepurl.com/ghzUOz .
Resources
How To Articles
- HOWTO: Support Integrated MLB Sales
- HOWTO: Automate TEvo Order Processing
- HOWTO: Setup a Third Party Automator
- HOWTO: Create Orders Using The API
- HOWTO: Create A New User For My Office
- HOW TO: Integrate the Riskified Fraud Service to your Website
- HOW TO: Process a Substitution via the API
- HOW TO: Automate Flash & TM Mobile Transfers
Building a Ticket Resale Website or App Using the Ticket Evolution API
- 01. Getting Access to the Ticket Evolution API
- 08. Event Landing Pages
- 11. Creating Orders
- 09. Creating a Client
- 10. Creating Credit Cards for a Client
- 02. Basic Terminology
- 03. Getting Technical
- 04. Comprehensive Search
- 05. Displaying Events Near Your Users
- 06. Performer Landing Pages
- 07. Venue Landing Pages
Current Version
The current version of our API is version 9, indicated by using /v9/
in the URI.
Sandbox:
https://api.sandbox.ticketevolution.com/v9/
Production:
https://api.ticketevolution.com/v9/
Libraries
Recent updates
-
Using BraintreeDec 03, 2024 • contributed by Daniel Weisbaum
-
Events / IndexNov 08, 2024 • contributed by Matt Coneybeare
-
Events / ShowNov 08, 2024 • contributed by Matt Coneybeare
-
Test Api Page can be DeletedOct 17, 2024 • contributed by Markis Piper (Unlicensed)
-
Listings / ShowOct 08, 2024 • contributed by J Cobb (Unlicensed)
-
Venue Configurations / ShowOct 01, 2024 • contributed by J Cobb (Unlicensed)
-
Processing Orders via WebhooksSept 30, 2024 • contributed by J Cobb (Unlicensed)
-
Signing requests with X-SignatureSept 26, 2024 • contributed by J Cobb (Unlicensed)
-
Orders / AcceptSept 25, 2024 • contributed by J Cobb (Unlicensed)
-
HOWTO: Automate TEvo Order ProcessingSept 17, 2024 • contributed by J Cobb (Unlicensed)
-
HOW TO: Automate Flash & TM Mobile TransfersSept 16, 2024 • contributed by J Cobb (Unlicensed)
-
Buy/Sell Examples for Orders / CreateSept 16, 2024 • contributed by J Cobb (Unlicensed)
-
Payments / CreateSept 16, 2024 • contributed by J Cobb (Unlicensed)
-
Orders / ShowSept 11, 2024 • contributed by J Cobb (Unlicensed)
-
Orders / CreateAug 27, 2024 • contributed by J Cobb (Unlicensed)