API Documentation

• API Methods
• Authentication
• API Errors

API Method /event_list_discounts

This method returns the list of discount codes created for a given event.

Arguments

authentication

This method controls access via required user authentication.

id integer

The ID of the event.

Example Request

Output Parameters

This method returns XML with the following structure:

discounts array

Array of discounts with the following structure:

discount_id integer

The discount ID.

codestring

The discount code.

amount_off float

The fixed amount off the ticket price.

percent_off float

The percentage off the ticket price.

tickets string

Comma-separated list of ticket IDs for which the discount applies.

start_date string

The discount start date and time, in ISO 8601 format (e.g., "2007-12-31 23:59:59").

end_date string

The discount end date and time, in ISO 8601 format (e.g., "2007-12-31 23:59:59").

quantity_available integer

Maximum number of times this discount can be used.

quantity_sold integer

Number of times this discount has been used.

Example XML Response

<?xml version="1.0" encoding="utf-8" ?>
<discounts>
	<discount>
		<discount_id>26669</discount_id>
		<code>Discount_Code2009</code>
		<amount_off>15.00</amount_off>
		<tickets>all</tickets>
		<start_date>2009-12-11 13:00:00</start_date>
		<end_date>2009-12-18 18:00:00</end_date>
		<quantity_available>500</quantity_available>
		<quantity_sold>350</quantity_sold>
	</discount>
</discounts>


<?xml version="1.0" encoding="utf-8" ?>
<discounts>
	<discount>
		<discount_id>27769</discount_id>
		<code>Discount_Code2010</code>
		<percent_off>10</percent_off>
		<tickets>8123456,8765400</tickets>
		<end_date>2009-12-18 18:00:00</end_date>
		<quantity_sold>350</quantity_sold>
	</discount>
</discounts>

Error Codes

This method may return these errors in an error document:

Request Error

The API request was not properly formed.

Application Key Error

There is a problem with the application key provided.

Authentication Error

The specified user was not found or the login credentials didn't match.

Event Error

Invalid event ID.

Not Found

No such event [12345678].

Discount error

No discount code found for this event.