Select an API to view Documentation: 


This API retrieves all the available cities with Special and Event data.


/cities



Name Data Type Required Description
api_key string YES API Key that was given to you at API registration
version string YES Version of the API (Current version = 2)

Sample Request

http://www.findmespecials.com/api/cities?api_key=YOUR_KEY&version=2



 

Response Values

Response Node Data Type Number of times occuring Description
response Node 1 Response body
response_header Node 1 Response summary.
Attributes include:
status:Response Status.
cities_count:Total number of cities available in result.
cities Node 1 Container for cities
city Node 0..cities_count Container for each city
Attributes include:
id:ID for city.
city.name string 1 for each city Name of city
city.state string 1 for each city State of city

 

Sample Response

      
<?xml version="1.0" encoding="UTF-8"?>
<response>
  <response_header status="OK" cities_count="2"/>
  <cities>
    <city id="97">
      <name>Atlanta</name>
      <state>NY</state>
    </city>
    <city id="128">
      <name>New York</name>
      <state>NY</state>
    </city>
  </cities>
</response>