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
Building a Ticket Resale Website or App Using the Ticket Evolution API
- 01. Getting Access to the Ticket Evolution API
- 02. Basic Terminology
- 03. Getting Technical
- 04. Comprehensive Search
- 05. Displaying Events Near Your Users
- 06. Performer Landing Pages
- 07. Venue Landing Pages
- 08. Event Landing Pages
- 11. Creating Orders
- 09. Creating a Client
- 10. Creating Credit Cards for a Client
How To Articles
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
-
Listings / ShowJul 22, 2024 • contributed by J Cobb
-
Shipments / CompleteJul 17, 2024 • contributed by J Cobb
-
DNS set up for TEvo Websites and Hosted CheckoutJul 08, 2024 • contributed by J Cobb
-
Hosted CheckoutJul 08, 2024 • contributed by J Cobb
-
Events / IndexMay 20, 2024 • contributed by J Cobb
-
Using BraintreeMay 16, 2024 • contributed by Bruce Lee
-
Fraud Protection by RiskifiedMay 10, 2024 • contributed by J Cobb
-
Signing requests with X-SignatureMay 06, 2024 • contributed by J Cobb
-
Affiliate Orders / CreateMay 03, 2024 • contributed by J Cobb
-
Shipments / UpdateApr 18, 2024 • contributed by J Cobb
-
Events / ShowApr 05, 2024 • contributed by J Cobb
-
Clients / Braintree Client TokenApr 03, 2024 • contributed by J Cobb
-
Merchant AccountsMar 26, 2024 • contributed by J Cobb
-
-
Using StripeMar 26, 2024 • contributed by J Cobb