Subnational1Code List and Search Web Service API

This is implemented in the IS/DataDeliveryREST code base.

URL

description

status

notes

ws/ref/subnational1/list

Return entire list of "state" names

coded, not deployed

 

ws/ref/subnational1/list?countryCode=<2-letter ISO country code>

Return list of "state" names found in the given country

coded, not deployed

 

ws/ref/subnational1/find?match=<string to match>

Return list of "state" names that match

not coded

Can wildcards be used in the match string?

parameter

required

default

value options

description

status

match

yes, for /find

n/a

 

String to match against "county" names. What kind of wildcards can be used?

not coded

locale

no

en_US

Java standard locale codes

locale in which to perform matching, and in which to provide names in response (when possible)

not coded

countryCode

no

n/a


2-letter ISO country code

coded, not deployed

format

no

csv

  • csv
  • xml

format to use for response

coded, not deployed

CSV Result Format

<country code>, <subnational1 code>, <name associated with subnational1 code>
<country code>, <subnational1 code>, <name associated with subnational1 code
<country code>, <subnational1 code>, <name associated with subnational1 code>

XML Result Format
<response>
  <header>
    <locale country="US" language="en"/>
    <timestamp>2008-02-21T12:37:32.546-05:00</timestamp>
    <criteria>
      <property name="match" value="seomthing"/>
      <property name="countryCode" value="US" description="United States"/>
    </criteria>
    <comment>
    </comment>
  </header>
  <result>
    <location countryCode="" subnational1Code="">name of the subnational1 region </location>
    <location countryCode="" subnational1Code="">name of the subnational1 region </location>
    <location countryCode="" subnational1Code="">name of the subnational1 region </location>
    <location countryCode="" subnational1Code="">name of the subnational1 region </location>
  </result>
</response>