Geographic Codes
This page documents the valid geographic codes accepted by various API endpoints.
Table of contents
- Countries and Territories in the Americas
- US Regions and States
- Selected US cities
- NIDSS
- European Countries
- FluSurv Locations
- Republic of Korea
- FluView Cities
Countries and Territories in the Americas
Multiple endpoints accept ISO 3166-1 alpha-2 country codes for countries and territories in the Americas.
Note: While the API accepts codes for all countries listed below, data may not be available for every country or territory.
Supported Codes
| Code | Name |
|---|---|
| AG | Antigua and Barbuda |
| AI | Anguilla |
| AR | Argentina |
| AW | Aruba |
| BB | Barbados |
| BL | Saint Barthelemy |
| BM | Bermuda |
| BO | Bolivia |
| BQ | Bonaire, Saint Eustatius and Saba |
| BR | Brazil |
| BS | Bahamas |
| BZ | Belize |
| CA | Canada |
| CL | Chile |
| CO | Colombia |
| CR | Costa Rica |
| CU | Cuba |
| CW | Curaçao |
| DO | Dominican Republic |
| EC | Ecuador |
| GD | Grenada |
| GF | French Guiana |
| GP | Guadeloupe |
| GT | Guatemala |
| GY | Guyana |
| HN | Honduras |
| HT | Haiti |
| JM | Jamaica |
| KN | Saint Kitts and Nevis |
| KY | Cayman Islands |
| LC | Saint Lucia |
| MF | Saint Martin (French part) |
| MQ | Martinique |
| MS | Montserrat |
| MX | Mexico |
| NI | Nicaragua |
| PA | Panama |
| PE | Peru |
| PR | Puerto Rico |
| PY | Paraguay |
| SR | Suriname |
| SV | El Salvador |
| SX | Sint Maarten (Dutch part) |
| TC | Turks and Caicos Islands |
| TT | Trinidad and Tobago |
| US | United States of America |
| UY | Uruguay |
| VC | Saint Vincent and the Grenadines |
| VE | Venezuela |
| VG | Virgin Islands (UK) |
| VI | Virgin Islands (US) |
US Regions and States
Multiple endpoints use standard US geographic codes. These include the national code, HHS regions, Census divisions, and state codes.
National Code
| Code | Name |
|---|---|
| nat | United States (National) |
HHS Regions
The US Department of Health and Human Services divides the country into 10 regions.
| Code | Region | States |
|---|---|---|
| hhs1 | Region 1 | CT, ME, MA, NH, RI, VT |
| hhs2 | Region 2 | NJ, NY, PR, VI |
| hhs3 | Region 3 | DE, DC, MD, PA, VA, WV |
| hhs4 | Region 4 | AL, FL, GA, KY, MS, NC, SC, TN |
| hhs5 | Region 5 | IL, IN, MI, MN, OH, WI |
| hhs6 | Region 6 | AR, LA, NM, OK, TX |
| hhs7 | Region 7 | IA, KS, MO, NE |
| hhs8 | Region 8 | CO, MT, ND, SD, UT, WY |
| hhs9 | Region 9 | AZ, CA, HI, NV, AS, GU, MP |
| hhs10 | Region 10 | AK, ID, OR, WA |
Census Divisions
The US Census Bureau divides the country into 9 divisions.
| Code | Division | States |
|---|---|---|
| cen1 | New England | CT, ME, MA, NH, RI, VT |
| cen2 | Mid-Atlantic | NJ, NY, PA |
| cen3 | East North Central | IL, IN, MI, OH, WI |
| cen4 | West North Central | IA, KS, MN, MO, NE, ND, SD |
| cen5 | South Atlantic | DE, DC, FL, GA, MD, NC, SC, VA, WV |
| cen6 | East South Central | AL, KY, MS, TN |
| cen7 | West South Central | AR, LA, OK, TX |
| cen8 | Mountain | AZ, CO, ID, MT, NV, NM, UT, WY |
| cen9 | Pacific | AK, CA, HI, OR, WA |
US States and Territories
Full list of 51 US states and territories used by multiple endpoints:
US States
| Code | Name |
|---|---|
| AK | Alaska |
| AL | Alabama |
| AR | Arkansas |
| AZ | Arizona |
| CA | California |
| CO | Colorado |
| CT | Connecticut |
| DC | District of Columbia |
| DE | Delaware |
| FL | Florida |
| GA | Georgia |
| HI | Hawaii |
| IA | Iowa |
| ID | Idaho |
| IL | Illinois |
| IN | Indiana |
| KS | Kansas |
| KY | Kentucky |
| LA | Louisiana |
| MA | Massachusetts |
| MD | Maryland |
| ME | Maine |
| MI | Michigan |
| MN | Minnesota |
| MO | Missouri |
| MS | Mississippi |
| MT | Montana |
| NC | North Carolina |
| ND | North Dakota |
| NE | Nebraska |
| NH | New Hampshire |
| NJ | New Jersey |
| NM | New Mexico |
| NV | Nevada |
| NY | New York |
| OH | Ohio |
| OK | Oklahoma |
| OR | Oregon |
| PA | Pennsylvania |
| RI | Rhode Island |
| SC | South Carolina |
| SD | South Dakota |
| TN | Tennessee |
| TX | Texas |
| UT | Utah |
| VA | Virginia |
| VT | Vermont |
| WA | Washington |
| WI | Wisconsin |
| WV | West Virginia |
| WY | Wyoming |
US Territories
| Code | Name |
|---|---|
| PR | Puerto Rico |
| VI | Virgin Islands |
| GU | Guam |
| AS | American Samoa |
| MP | Northern Mariana Islands |
| FM | Federated States of Micronesia |
| MH | Marshall Islands |
| PW | Palau |
Selected US cities
Selected US cities used by multiple endpoints.
| Code |
|---|
| Abilene_TX |
| Akron_OH |
| Albany_NY |
| Albuquerque_NM |
| Alexandria_VA |
| Allentown_PA |
| Amarillo_TX |
| Anaheim_CA |
| Anchorage_AK |
| Ann_Arbor_MI |
| Arlington_TX |
| Arlington_VA |
| Atlanta_GA |
| Austin_TX |
| Bakersfield_CA |
| Baltimore_MD |
| Baton_Rouge_LA |
| Berkeley_CA |
| Birmingham_AL |
| Boise_ID |
| Boston_MA |
| Boulder_CO |
| Buffalo_NY |
| Cary_NC |
| Charlotte_NC |
| Chicago_IL |
| Cleveland_OH |
| Colorado_Springs_CO |
| Columbia_SC |
| Columbus_OH |
| Dallas_TX |
| Dayton_OH |
| Denver_CO |
| Des_Moines_IA |
| Durham_NC |
| Eugene_OR |
| Fresno_CA |
| Ft_Worth_TX |
| Gainesville_FL |
| Grand_Rapids_MI |
| Greensboro_NC |
| Greenville_SC |
| Honolulu_HI |
| Houston_TX |
| Indianapolis_IN |
| Irvine_CA |
| Irving_TX |
| Jacksonville_FL |
| Jackson_MS |
| Kansas_City_MO |
| Knoxville_TN |
| Las_Vegas_NV |
| Lexington_KY |
| Lincoln_NE |
| Little_Rock_AR |
| Los_Angeles_CA |
| Lubbock_TX |
| Madison_WI |
| Memphis_TN |
| Mesa_AZ |
| Miami_FL |
| Milwaukee_WI |
| Nashville_TN |
| Newark_NJ |
| New_Orleans_LA |
| New_York_NY |
| Norfolk_VA |
| Oakland_CA |
| Oklahoma_City_OK |
| Omaha_NE |
| Orlando_FL |
| Philadelphia_PA |
| Phoenix_AZ |
| Pittsburgh_PA |
| Plano_TX |
| Portland_OR |
| Providence_RI |
| Raleigh_NC |
| Reno_NV |
| Reston_VA |
| Richmond_VA |
| Rochester_NY |
| Roswell_GA |
| Sacramento_CA |
| Salt_Lake_City_UT |
| Santa_Clara_CA |
| San_Antonio_TX |
| San_Diego_CA |
| San_Francisco_CA |
| San_Jose_CA |
| Scottsdale_AZ |
| Seattle_WA |
| Somerville_MA |
| Spokane_WA |
| Springfield_MO |
| State_College_PA |
| St_Louis_MO |
| St_Paul_MN |
| Sunnyvale_CA |
| Tampa_FL |
| Tempe_AZ |
| Tucson_AZ |
| Tulsa_OK |
| Washington_DC |
| Wichita_KS |
NIDSS
Geographic codes used by NIDSS Flu and NIDSS Dengue endpoints.
Taiwan Regions
Regions of Taiwan.
| Code |
|---|
| nationwide |
| central |
| eastern |
| kaoping |
| northern |
| southern |
| taipei |
Taiwan Cities and Counties
Administrative divisions of Taiwan.
| Code |
|---|
| changhua_county |
| chiayi_city |
| chiayi_county |
| hsinchu_city |
| hsinchu_county |
| hualien_county |
| kaohsiung_city |
| keelung_city |
| kinmen_county |
| lienchiang_county |
| miaoli_county |
| nantou_county |
| new_taipei_city |
| penghu_county |
| pingtung_county |
| taichung_city |
| tainan_city |
| taipei_city |
| taitung_county |
| taoyuan_city |
| yilan_county |
| yunlin_county |
European Countries
European countries and regions used by the ECDC ILI endpoint.
| Name |
|---|
| Armenia |
| Austria |
| Azerbaijan |
| Belarus |
| Belgium |
| Czech Republic |
| Denmark |
| Estonia |
| Finland |
| France |
| Georgia |
| Iceland |
| Ireland |
| Israel |
| Italy |
| Kazakhstan |
| Kosovo* |
| Kyrgyzstan |
| Latvia |
| Lithuania |
| Luxembourg |
| Malta |
| Moldova |
| Montenegro |
| Netherlands |
| North Macedonia |
| Norway |
| Poland |
| Portugal |
| Romania |
| Russia |
| Serbia |
| Slovakia |
| Slovenia |
| Spain |
| Switzerland |
| Tajikistan |
| Turkey |
| Turkmenistan |
| Ukraine |
| United Kingdom - England |
| United Kingdom - Northern Irel |
| United Kingdom - Scotland |
| United Kingdom - Wales |
| Uzbekistan |
FluSurv Locations
Locations used by the FluSurv endpoint.
| Code | Description |
|---|---|
| CA | California |
| CO | Colorado |
| CT | Connecticut |
| GA | Georgia |
| IA | Iowa |
| ID | Idaho |
| MD | Maryland |
| MI | Michigan |
| MN | Minnesota |
| NM | New Mexico |
| NY_albany | New York (Albany) |
| NY_rochester | New York (Rochester) |
| OH | Ohio |
| OK | Oklahoma |
| OR | Oregon |
| RI | Rhode Island |
| SD | South Dakota |
| TN | Tennessee |
| UT | Utah |
| network_all | All Networks |
| network_eip | Emerging Infections Program |
| network_ihsp | Influenza Hospitalization Surveillance Project |
Republic of Korea
Geographic codes used by the KCDC ILI endpoint.
| Code | Name |
|---|---|
| ROK | Republic of Korea |
FluView Cities
Specific cities used by the FluView endpoint.
| City | Code |
|---|---|
| Chicago | ord |
| Los Angeles | lax |
| New York City | jfk |
Note on New York
In the CDC FluView system, New York State and New York City are often reported separately.
ny_minus_jfkrepresents New York State excluding NYC.jfkrepresents New York City.nyrepresents the entire state (the sum of the two).