GET api/states/{state}/cities

This call will retrieve all the cities within a given state

Request Information

URI Parameters

NameDescriptionTypeAdditional information
state

the name of the state you want to retrieve all the cities for, short in two letters like IA for Iowa

string

Required

Body Parameters

None.

Response Information

Resource Description

all the cities that is within the borders of the given state

Collection of Geo
NameDescriptionTypeAdditional information
Id

globally unique identifier

None.

Zip

integer

None.

State

string

None.

City

string

None.

Longitude

decimal number

None.

Latitude

decimal number

None.

Response Formats

application/json, text/json

Sample:
[
  {
    "Id": "4330f174-5858-40a2-9411-08fa6c24fb15",
    "Zip": 2,
    "State": "sample string 3",
    "City": "sample string 4",
    "Longitude": 5.1,
    "Latitude": 6.1
  },
  {
    "Id": "4330f174-5858-40a2-9411-08fa6c24fb15",
    "Zip": 2,
    "State": "sample string 3",
    "City": "sample string 4",
    "Longitude": 5.1,
    "Latitude": 6.1
  }
]

application/xml, text/xml

Sample:
<ArrayOfGeo xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/GeoAPI.Models">
  <Geo>
    <City>sample string 4</City>
    <Id>4330f174-5858-40a2-9411-08fa6c24fb15</Id>
    <Latitude>6.1</Latitude>
    <Longitude>5.1</Longitude>
    <State>sample string 3</State>
    <Zip>2</Zip>
  </Geo>
  <Geo>
    <City>sample string 4</City>
    <Id>4330f174-5858-40a2-9411-08fa6c24fb15</Id>
    <Latitude>6.1</Latitude>
    <Longitude>5.1</Longitude>
    <State>sample string 3</State>
    <Zip>2</Zip>
  </Geo>
</ArrayOfGeo>