API Methods

HoldMyTicket REST API Services

Welcome to the very basic API Documentation for Hold My Ticket. We are working on improving our documentation, but please bare with us in the mean time. With our API you can custom build an interface using REST services. You can see the API Methods we currently offer under the API Methods tab above.

Example Request using the getInfo function.


			curl -0 http://holdmyticket.com/api/events/getInfo/api_key/YOUR_API_KEY_GOES_HERE/event/341

Example Response


			
			<?xml version='1.0' encoding='utf-8'?>
			<event>
				<id>341</id>
				<title>Super Salom Skiing Event</title>
				<name_sec></name_sec>
				<name_third></name_third>
				<dates starts='2009-11-16 15:00:00' ends='2009-11-16 20:00:00' doors='2009-11-16 15:00:00' cancel='0000-00-00 00:00:00'/>
				<description></description>
					<venue id='15'>
					<name>Lions Den</name>
					<address1>123 Lion Ave</address1>
					<address2></address2>
					<city>Albuquerque</city>
					<state>NM</state>
					<zip>87777</zip>
					<phone>505-555-1234</phone>
				</venue>
				<ages_description>All Ages</ages_description>
				<alt_ticket_sales></alt_ticket_sales>
				<alt_ticket_price>0.00</alt_ticket_price>
				<alt_ticket_price_max>0.00</alt_ticket_price_max>
			</event>

hmt.events.getInfo

http://holdmyticket.com/api/events/getInfo/api_key/{api-key}/event/{event-id}

Returns a information for a given event

Authentication

This method does not require authentication.

Arguments

api_key (Required)

Your API key.

event

The ID of the event you wish to get information.

Example Response


		
		<event>
			<id>5803</id>
			<title>GLOBAL DANCEFEST • JourneysAFRICA</title>
			<name_sec>Celebrating 10 Years of International Contemporary Dance</name_sec>
			<name_third></name_third>
			<dates starts='2009-10-23 20:00:00' ends='2009-10-31 22:00:00' doors='2009-10-23 19:00:00' cancel='0000-00-00 00:00:00'/>
			<description></description>
			<flyer>http://holdmyticket.com/flyers2/42726f6d1531694db9d214dd704a1df3.jpg</flyer>	
			<flyer_mid>http://holdmyticket.comimage not found</flyer_mid>
			<flyer_thumb>http://holdmyticket.comimage not found</flyer_thumb>
			<flyer_square>http://holdmyticket.comimage not found</flyer_square>
			<venue id='109'>
				<name> N4th Theater</name>
				<address1>4904 Fourth Street NW</address1>
				<address2></address2>
				<city>Albuquerque</city>
				<state>NM</state>
				<zip>87107</zip>
				<phone>505-345-2872</phone>
			</venue>
			<ages_description>All Ages</ages_description>
			<alt_ticket_sales></alt_ticket_sales>
			<alt_ticket_price>0.00</alt_ticket_price>
			<alt_ticket_price_max>0.00</alt_ticket_price_max>
			<sub_events>
				<sub_event>
					<id>5804</id>
					<title>(IN)DEPENDENCE Panaibra Gabriel, choreographer, MOZAMBIQUE</title>
					<name_sec></name_sec>
					<name_third></name_third>
					<dates starts='2009-10-23 20:00:00' ends='2009-10-23 22:00:00' doors='2009-10-23 19:00:00' cancel='0000-00-00 00:00:00'/>
					<description></description>
					<flyer>http://holdmyticket.com/flyers2/c8a563b5dabc3e4df2bb72d4ccfd7f66.jpg</flyer>	
					<flyer_mid>http://holdmyticket.comimage not found</flyer_mid>
					<flyer_thumb>http://holdmyticket.comimage not found</flyer_thumb>
					<flyer_square>http://holdmyticket.comimage not found</flyer_square>
					<venue id='109'>
						<name> N4th Theater</name>
						<address1>4904 Fourth Street NW</address1>
						<address2></address2>
						<city>Albuquerque</city>
						<state>NM</state>
						<zip>87107</zip>
					</venue>
					<ages_description>All Ages</ages_description>
					<buy_link>http://holdmyticket.com/mini/mini.php?id=5804</buy_link>
				</sub_event>
			</sub_events>
		</event>

hmt.events.getList

http://holdmyticket.com/api/events/getList/api_key/{api-key}/venues/{venues}

Returns a list of events

Authentication

This method requires authentication.

Arguments

api_key (Required)

Your API key.

venues

Filter events by venue. Example (1454|2144) (Delimit venue IDs with a "|")

If venues is not specified, all venues will be selected

start_filter

Defaults to today. Format: "2009-10-15 05:00:00"

end_filter

Defaults to 1 year from today. Format: "2010-10-15 05:00:00"

Example Response


		
		<events>
			<event>
				<id>5803</id>
				<title>GLOBAL DANCEFEST • JourneysAFRICA</title>
				<name_sec>Celebrating 10 Years of International Contemporary Dance</name_sec>
				<name_third></name_third>
				<dates starts='2009-10-23 20:00:00' ends='2009-10-31 22:00:00' doors='2009-10-23 19:00:00' cancel='0000-00-00 00:00:00'/>
				<description></description>
				<flyer>http://holdmyticket.com/flyers2/42726f6d1531694db9d214dd704a1df3.jpg</flyer>	
				<flyer_mid>http://holdmyticket.comimage not found</flyer_mid>
				<flyer_thumb>http://holdmyticket.comimage not found</flyer_thumb>
				<flyer_square>http://holdmyticket.comimage not found</flyer_square>
				<venue id='109'>
					<name> N4th Theater</name>
					<address1>4904 Fourth Street NW</address1>
					<address2></address2>
					<city>Albuquerque</city>
					<state>NM</state>
					<zip>87107</zip>
					<phone>505-345-2872</phone>
				</venue>
				<ages_description>All Ages</ages_description>
				<alt_ticket_sales></alt_ticket_sales>
				<alt_ticket_price>0.00</alt_ticket_price>
				<alt_ticket_price_max>0.00</alt_ticket_price_max>
				<sub_events>
					<sub_event>
						<id>5804</id>
						<title>(IN)DEPENDENCE Panaibra Gabriel, choreographer, MOZAMBIQUE</title>
						<name_sec></name_sec>
						<name_third></name_third>
						<dates starts='2009-10-23 20:00:00' ends='2009-10-23 22:00:00' doors='2009-10-23 19:00:00' cancel='0000-00-00 00:00:00'/>
						<description></description>
						<flyer>http://holdmyticket.com/flyers2/c8a563b5dabc3e4df2bb72d4ccfd7f66.jpg</flyer>	
						<flyer_mid>http://holdmyticket.comimage not found</flyer_mid>
						<flyer_thumb>http://holdmyticket.comimage not found</flyer_thumb>
						<flyer_square>http://holdmyticket.comimage not found</flyer_square>
						<venue id='109'>
							<name> N4th Theater</name>
							<address1>4904 Fourth Street NW</address1>
							<address2></address2>
							<city>Albuquerque</city>
							<state>NM</state>
							<zip>87107</zip>
						</venue>
						<ages_description>All Ages</ages_description>
						<buy_link>http://holdmyticket.com/mini/mini.php?id=5804</buy_link>
					</sub_event>
				</sub_events>
			</event>
			<event>
				...
			</event>
		</events>

hmt.events.getHTML

http://holdmyticket.com/api/events/getHTML/api_key/{api-key}/event/{event-id}

Returns a list of events

Authentication

This method requires authentication.

Arguments

api_key (Required)

Your API key.

event

The ID of the event you wish to get HTML content.

Example Response


		
		CUSTOM EVENT HTML WILL OUTPUTTED AS SPECIFIED IN EVENT HTML FIELD

hmt.venues.getInfo

http://holdmyticket.com/api/venues/getInfo/api_key/{api-key}/venue/{venue-id}

Returns information for a venue

Authentication

This method requires authentication.

Arguments

api_key (Required)

Your API key.

venue

The ID of the venue you wish to get information.

Example Response


		
		<venue id='109'>
			<name>N4th Theater</name>
			<address1>4904 Fourth Street NW</address1>
			<address2></address2>
			<city>Albuquerque</city>
			<state>NM</state>
			<zip>87107</zip>
			<phone>505-345-2872</phone>
		</venue>

hmt.venues.getList

http://holdmyticket.com/api/venues/getList/api_key/{api-key}

Returns all venues and information for each venue

Authentication

This method requires authentication.

Arguments

api_key (Required)

Your API key.

Example Response


		
		<venues>
			<venue id='109'>
				<name>N4th Theater</name>
				<address1>4904 Fourth Street NW</address1>
				<address2></address2>
				<city>Albuquerque</city>
				<state>NM</state>
				<zip>87107</zip>
				<phone>505-345-2872</phone>
			</venue>
			<venue>
				...
			</venue>
		</venues>

hmt.tickets.getAvailable

http://holdmyticket.com/api/tickets/getAvailable/api_key/{api-key}/event/{event-id}

Returns available ticket information for an event

Authentication

This method requires authentication.

Arguments

api_key (Required)

Your API key.

event

The ID of the event you wish to get ticket information.

Example Response


		
		<tickets>
			<ticket>
				<id>878999</id>
				<description>General Admission</description>
				<price>15.50</price>
				<day_of_show_price>18.00</day_of_show_price>
			</ticket>
			<ticket>
				...
			</ticket>
		</tickets>

hmt.media.getEvent

http://holdmyticket.com/api/media/getEvent/api_key/{api-key}/event/{event-id}

Returns available media for a certain event. Media consists of videos / images / flyers that are tied to the event.

Authentication

This method requires authentication.

Arguments

api_key (Required)

Your API key.

event

The ID of the event you wish to get media information.

Example Response


		
		<media>
			<flyer>
				<url>{flyer_url}</url>
			</flyer>
			<video>
				<video_site>YouTube</video_site>
				<title>Title of the video</title>
				<embed_code>{embed code from youtube}</embed_code>
			</video>
			<video>
				<video_site>Vimeo</video_site>
				<title>Title of the video</title>
				<embed_code>{embed code from vimeo}</embed_code>
			</video>
			<image>
				<title>Title of the image</title>
				<url>{image_url}</url>
			</image>
		</media>

hmt.showtimes.getInfo

http://holdmyticket.com/api/showtimes/getInfo/api_key/{api-key}/showtime_id/{showtime-id}

Returns information for a showtime and any attached attractions

Authentication

This method requires authentication.

Arguments

api_key (Required)

Your API key.

showtime_id

The ID of the showtime you wish to get information.

Example Response


		
		<showtime>
			<id>1</id>
			<event_id>7531</event_id>
			<showtime>2009&#45;12&#45;22 19:00:00</showtime>
			<attraction>
				<id>23466</id>
				<name>Metallica</name>
				<description>The legend band of rock.</description>
			</attraction>
		</showtime>