TickeTing Inc.
License
The TickeTing REST API v3 allows developers to integrate with the TickeTing platform, from creating hosts and events to buying and transferring tickets. This reference document will walk you through authenticating against the API and the full list of available endpoints, their permissions and functionality.
The TickeTing API uses API keys to authenticate requests. You must provide a valid API Key in the X-API-Key header of each request you make. There are two ways to get a valid API Key:
Start a session with a valid TickeTing username and password (this gives access based on the user's permissions).
Secure an integration key from a system administrator. Integration keys grant an access level determined by the administrator on creation.
Session Authentication and Integration Keys are covered in the Authentication section of this reference.
Omitting the X-API-Key Header from your request or specifying an empty value, will result in the following 401 error response.
{
"message": "Your request could not be authenticated."
}If an invalid X-API-Key value is provided, or the provided key is valid, but does not have permission to access the requested resource, the following 403 error response is sent.
{
"message": "You are restricted from accessing this resource."
}All requests to the API must advertise the version of the API they wish to integrate with. This ensures compatability with the server. This is done by including the X-Client-Version header in every request along with the expected API version. In this way the server can indicate when a client must upgrade to avoid breaking changes.
If the X-Client-Version header is omitted from your request, or the provided version does not meet the minimum required by the API, the following 412 error response is sent.
{
"error": "Please upgrade your client to complete this request"
}Requests to the API can result in a 404 error for two reasons:
The endpoint you are trying to access does not exist, in which case you will see the following response:
{
"message": "The requested endpoint /invalid/endpoint does not exist on this server."
}The endpoint you are requesting exists, but a resource cannot be located using the given URI. For example, trying to access an event resource with a non-existant ID such as /events/0000000 will result in the following response:
{
"error": "There is presently no resource with the given URI."
}This version of the API is still under development and there may be bugs and runtime errors encountered while processing your request. In these cases, a 500 error response will be sent with the message below. If such a message is received, please contact a system administrator with the details of your request (endpoint, method, headers and payload), so they may reproduce and resolve the issue.
{
"message": "There was a server error while excuting this request. Please see system logs for details."
}https://docs.ticketingevents.com/_mock/openapi/
https://qa.ticketingevents.com/v3/
https://api.ticketingevents.com/v3/
Initiate a transfer of one or more tickets from the requesting user to another TickeTing user. Initiating a transfer, does not automatically move tickets between accounts, but instead sends a transfer request. This request must first be claimed at which time the tickets themselves are transferred. If the transfer request is cancelled or rejected, no tickets change hands.
One or more tickets, for one or multiple events, can be sent in a single transfer. Tickets that are part of an open transfer (not yet claimed, canclled or rejected) enter into a pending state in which they cannot be redeemed, only becoming usable again once a decision is taken on the transfer.
https://docs.ticketingevents.com/_mock/openapi/transfers
https://qa.ticketingevents.com/v3/transfers
https://api.ticketingevents.com/v3/transfers
curl -i -X POST \
https://docs.ticketingevents.com/_mock/openapi/transfers \
-H 'Content-Type: application/json' \
-H 'X-API-Key: YOUR_API_KEY_HERE' \
-d '{
"recipient": "BI-5A939D5D",
"items": {
"/events/16993717817996/sections/16993964783416": 2
}
}'{ "self": "/transfers/17096551195817", "status": "Pending", "items": [ { … } ], "sender": { "self": "/accounts/MO-6A39EE8D", "number": "MO-6A39EE8D", "username": "mothers.milk", "email": "marvin.milk@usmc.gov", "firstName": "Marvin", "lastName": "Milk" }, "recipient": { "self": "/accounts/BI-5A939D5D", "number": "BI-5A939D5D", "username": "the_butcher", "email": "elcapitaine@yahoo.com", "firstName": "Billy", "lastName": "Butcher" } }
https://docs.ticketingevents.com/_mock/openapi/transfers
https://qa.ticketingevents.com/v3/transfers
https://api.ticketingevents.com/v3/transfers
curl -i -X GET \
'https://docs.ticketingevents.com/_mock/openapi/transfers?page=1&recipient=string&records=25&sender=string&status=Pending' \
-H 'X-API-Key: YOUR_API_KEY_HERE'{ "page": 2, "records": 8, "entries": [ { … }, { … } ] }
https://docs.ticketingevents.com/_mock/openapi/transfers/{transfer}
https://qa.ticketingevents.com/v3/transfers/{transfer}
https://api.ticketingevents.com/v3/transfers/{transfer}
curl -i -X GET \
'https://docs.ticketingevents.com/_mock/openapi/transfers/{transfer}' \
-H 'X-API-Key: YOUR_API_KEY_HERE'{ "self": "/transfers/17096551195817", "status": "Pending", "items": [ { … } ], "sender": { "self": "/accounts/MO-6A39EE8D", "number": "MO-6A39EE8D", "username": "mothers.milk", "email": "marvin.milk@usmc.gov", "firstName": "Marvin", "lastName": "Milk" }, "recipient": { "self": "/accounts/BI-5A939D5D", "number": "BI-5A939D5D", "username": "the_butcher", "email": "elcapitaine@yahoo.com", "firstName": "Billy", "lastName": "Butcher" } }