API Method /venues/resolve

Given a location string, return a venue ID suitable for /events/new if possible.

This method searches through Eventful's database of venues and cities for the closest match possible. If only one venue match is found, that venue is returned. If more than one is found, the top match is returned along with a list of alternative venues. If no matches are found, a "fail" status is returned.

If the location string matches a city more closely than any venues, a TBD venue in that city is returned. However, venue matches will be favored if they seem to fit more closely. For instance, "Paris" will return a TBD venue in Paris, France, and "Las Vegas" will return a TBD in that city, but "Paris Las Vegas" will return the venue ID for the Paris Hotel in Las Vegas.

Arguments

authentication
This method uses optional user authentication when creating a venue.
location string
A venue name and/or city.

Example Request

http://api.eventful.com/rest/events/dates/resolve?app_key=test_key&location=Mo+Pitkins

Output Parameters

Output from this function is an XML block with the following constructs.
status string
"ok" if the provided date string could be resolved, "fail" if not.
original string
The original where string provided.
date_used string
The parts of the original string which were used to determine this date.
start_time date
The start_time implied by the date string, in ISO 8601 format.
end_time date
The end_time implied by the date string, in ISO 8601 format.
all_day boolean
1 (true) if this event happens all day or has no specific time.

Example XML Responses

<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</id>
  <original>Mo Pitkins</message>
  <where_used>Mo Pitkins</where_used>
  <venue_id>V0-001-000305886-7</venue_id>
  <venue_name>Mo Pitkin's House of Satisfaction</venue_name>
  <location>New York, NY</location>
  <venues/> 
</response>
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>ok</id>
  <original>House of Blues</message>
  <where_used>House of Blues</where_used>
  <venue_id>V0-001-000305886-7</venue_id>
  <venue_name>House of Blues Las Vegas</venue_name>
  <location>Las Vegas, NV</location>
  <venues>
    <venue>
      <id>V0-001-000305886-7</id>
      <venue_name>House of Blues Las Vegas</venue_name>
      <address>555 Las Vegas Blvd</address>
      <location>Las Vegas, NV</location>
    </venue>
    <venue>
      <id>V0-001-000305887-6</id>
      <venue_name>House of Blues San Diego</venue_name>
      <address>123 5th Street</address>
      <location>San Diego, CA</location>
    </venue>
    ...
  </venues>
</response>
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <status>fail</id>
  <original>Totally Fake Auditorium</message>
  <where_used></where_used>
  <venue_id></venue_id>
  <venue_name></venue_name>
  <location></location>
  <venues/> 
</response>