ParkWhiz API: Venue

Venue and event information. The JSON API uses a URL structure similar to the main ParkWhiz website. For example, the URL to return JSON data for Fenway Park would be http://api.parkwhiz.com/fenway-park-parking/

Request

http://api.parkwhiz.com/[venue_url]/ GET

Parameters

Field Type Description
key string required ParkWhiz public API key
start integer Optional event start time, expressed as a Unix timestamp. If there is an event at the venue within 12 hours of the provided start time, a 301 redirect to the event URL will be issued, returning detailed parking information about the event. The redirect can be prevented by adding a no_event_301 parameter.
end integer Optional event end time, expressed as a Unix timestamp.
page integer Only 20 events are returned per API call. Use the page parameter to see more results.

Example Call

http://api.parkwhiz.com/fenway-park-parking/?page=2&no_event_301=1&key=62d882d8cfe5680004fa849286b6ce20

Returns

Field Type Description
venue_name string The name of the venue
parkwhiz_url string URL of the human-readable page for this venue on ParkWhiz.com
address string Street address of the venue
city string City of the venue
state string US state or Canadian province of the venue
zip string Postal code of the venue
type string The type of venue. One of: airport, sports, theater, park
timezone string The venue timezone
lat float Latitude of the venue
lng float Longitude of the venue
locations integer Number of locations returned
min_price float Minimum price of the returned search results. This field is null if there are no search results.
max_price float Maximum price of the returned search results. This field is null if there are no search results.
min_distance integer Minimum distance in feet of the returned search results. This field is null if there are no search results.
max_distance integer Maximum distance in feet of the returned search results. This field is null if there are no search results.
amenities object A hash indicating how many of the returned locations offer the available amenities
num_events integer Total number of events at this venue. Only 20 events are returned at one time. Use the page parameter to browse events.
page integer The currently returned page
events array A list of 25 upcoming events at the venue, in chronological order
parking_listings array A list of parking listings that matched the search parameters. The default sorting orders the results in ascending order by distance. Each entry has the following format:

events Object Parameters

Field Type Description
event_name string The name of the event
event_id integer The id of the event
parkwhiz_url string URL of the event in human-readable form on ParkWhiz.com
api_url string URL to retrieve more info about this event via the JSON API
start_utc string The start time of the event, expressed as a UTC date and time string
end string The end time of the event, expressed as a UTC date and time string
start integer The start time of the event, expressed as a Unix timestamp in the local timezone
end integer The end time of the event, expressed as a Unix timestamp in the local timezone
parking_locations integer The number of available parking locations for this event
min_price float The price of the least expensive parking for this event
min_distance integer The distance from the event of the closest available parking, expressed in feet

Example Response

{
	venue_name:"Madison Square Garden",
	address:"4 Pennsylvania Plaza",
	city:"New York",
	state:"NY",
	zip:"10001",
	type:"sports",
	timezone:"America/New_York",
	lat:40.7504611452,
	lng:-73.993462324161,
	parkwhiz_url:"http://parkwhiz.com/search/?destination=Madison+Square+Garden&start=1412870400&end=1412881200&pwa=ee51",
	locations:36,
	min_price:15,
	max_price:89,
	min_distance:792,
	max_distance:5153,
	amenities:{
		shuttle:0,
		eticket:55,
		perk:9,
		valet:54,
		indoor:32,
		handicap:13,
		restroom:8,
		security:6,
		tailgate:0,
		rv:0,
		unobstructed:7,
		attended:55,
		reentry_allowed:0
	},
	num_events:129,
	pages:6,
	page:1,
	events:[
		{
			event_name:"Aziz Ansari",
			event_id:247349,
			parkwhiz_url:"http://parkwhiz.com/madison-square-garden-parking/aziz-ansari-247349/?pwa=ee51",
			api_url:"http://api.parkwhiz.com/madison-square-garden-parking/aziz-ansari-247349/",
			start:1412895600,
			end:1412902800,
			timezone:"America/New_York",
			start_utc:"2014-10-09 23:00:00",
			end_utc:"2014-10-10 01:00:00",
			parking_locations:36,
			min_price:12,
			min_distance:792
		},
		{
			event_name:"Aziz Ansari",
			event_id:267877,
			parkwhiz_url:"http://parkwhiz.com/madison-square-garden-parking/aziz-ansari-267877/?pwa=ee51",
			api_url:"http://api.parkwhiz.com/madison-square-garden-parking/aziz-ansari-267877/",
			start:1412908200,
			end:1412915400,
			timezone:"America/New_York",
			start_utc:"2014-10-10 02:30:00",
			end_utc:"2014-10-10 04:30:00",
			parking_locations:26,
			min_price:12,
			min_distance:792
		},
		{
			event_name:"X Japan",
			event_id:261254,
			parkwhiz_url:"http://parkwhiz.com/madison-square-garden-parking/x-japan-261254/?pwa=ee51",
			api_url:"http://api.parkwhiz.com/madison-square-garden-parking/x-japan-261254/",
			start:1413072000,
			end:1413082800,
			timezone:"America/New_York",
			start_utc:"2014-10-12 00:00:00",
			end_utc:"2014-10-12 03:00:00",
			parking_locations:34,
			min_price:12,
			min_distance:792
		},
		...
	],
	parking_listings:[
		{
			location_name:"MTP Parking",
			location_id:4999,
			listing_id:165644,
			start:1412870400,
			end:1412881200,
			parkwhiz_url:"http://parkwhiz.com/p/new-york-parking/320-w-30th-st/?start=1412870400&end=1412881200&pwa=ee51",
			api_url:"http://api.parkwhiz.com/p/new-york-parking/320-w-30th-st/?start=1412870400&end=1412881200",
			address:"320 W. 30th St.",
			city:"New York",
			state:"NY",
			zip:"10001",
			lat:40.74992390415,
			lng:-73.996237165012,
			distance:792,
			recommendations:17,
			reservation:1,
			eticket:1,
			valet:1,
			indoor:1,
			shuttle:0,
			tailgate:0,
			security:0,
			restroom:0,
			attended:1,
			rv:0,
			available_spots:5,
			price:25,
			price_formatted:"$25",
			www_reserve_url:"http://parkwhiz.com/reserve/?id=165644&start=1412870400&end=1412881200&pwa=ee51",
			api_reserve_url:"http://api.parkwhiz.com/reserve/?id=165644&start=1412870400&end=1412881200&pwa=ee51"
		},
		{
			location_name:"LittleMan Parking",
			location_id:4402,
			listing_id:182771,
			start:1412870400,
			end:1412881200,
			parkwhiz_url:"http://parkwhiz.com/p/new-york-parking/211-w-29th-st/?start=1412870400&end=1412881200&pwa=ee51",
			api_url:"http://api.parkwhiz.com/p/new-york-parking/211-w-29th-st/?start=1412870400&end=1412881200",
			address:"211 W. 29th St.",
			city:"New York",
			state:"NY",
			zip:"10001",
			lat:40.748220964188,
			lng:-73.993464519014,
			distance:818,
			recommendations:93,
			reservation:1,
			eticket:1,
			valet:1,
			indoor:0,
			shuttle:0,
			tailgate:0,
			security:0,
			restroom:0,
			attended:1,
			rv:0,
			available_spots:10,
			price:35,
			price_formatted:"$35",
			www_reserve_url:"http://parkwhiz.com/reserve/?id=182771&start=1412870400&end=1412881200&pwa=ee51",
			api_reserve_url:"http://api.parkwhiz.com/reserve/?id=182771&start=1412870400&end=1412881200&pwa=ee51"
		},
		{
			location_name:"Parking Management",
			location_id:1608,
			listing_id:176690,
			start:1412870400,
			end:1412881200,
			parkwhiz_url:"http://parkwhiz.com/p/new-york-parking/124-w-31-st/?start=1412870400&end=1412881200&pwa=ee51",
			api_url:"http://api.parkwhiz.com/p/new-york-parking/124-w-31-st/?start=1412870400&end=1412881200",
			address:"124 W. 31 St.",
			city:"New York",
			state:"NY",
			zip:"10001",
			lat:40.748134,
			lng:-73.990447,
			distance:1191,
			recommendations:1222,
			reservation:1,
			eticket:1,
			valet:1,
			indoor:0,
			shuttle:1,
			tailgate:0,
			security:1,
			restroom:0,
			attended:1,
			rv:0,
			available_spots:10,
			price:40,
			price_formatted:"$40",
			www_reserve_url:"http://parkwhiz.com/reserve/?id=176690&start=1412870400&end=1412881200&pwa=ee51",
			api_reserve_url:"http://api.parkwhiz.com/reserve/?id=176690&start=1412870400&end=1412881200&pwa=ee51"
		},
		...
	]
}