Appearance
State Codes
The CDS Global API supports state / region codes for a limited set of countries.
These codes should be used when providing address or location data in your requests.
Important
⚠️ State codes are only accepted for specific countries.
If you include a state code for a country that does not support them, your request will be rejected.
State codes are currently supported for:
- Australia (AU)
- Canada (CA)
- United States (US)
When to use state codes
You should include a state code when submitting data such as:
- Customer addresses
- Billing or shipping information
- Location-specific records
Example: { "country": "US", "state": "CA" }
Format
- State codes are short uppercase strings
- Format varies slightly by country (e.g. CA, NSW, QC)
- Always use the exact values listed below
Australia
| State | State Code |
|---|---|
| New South Wales | NSW |
| Northern Territory | NT |
| Queensland | QLD |
| South Australia | SA |
| Tasmania | TAS |
| Victoria | VIC |
| Western Australia | WA |
Canada
| State | State Code |
|---|---|
| Alberta | AB |
| British Columbia | BC |
| Manitoba | MB |
| New Brunswick | NB |
| Newfoundland and Labrador | NL |
| Northwest Territories | NT |
| Nova Scotia | NS |
| Nunavut | NU |
| Ontario | ON |
| Prince Edward Island | PE |
| Quebec | QC |
| Saskatchewan | SK |
| Yukon | YT |
USA
| State | State Code |
|---|---|
| Alabama | AL |
| Alaska | AK |
| American Samoa | AS |
| Arizona | AZ |
| Arkansas | AR |
| California | CA |
| Colorado | CO |
| Connecticut | CT |
| Delaware | DE |
| District of Columbia | DC |
| Florida | FL |
| Georgia | GA |
| Guam | GU |
| Hawaii | HI |
| Idaho | ID |
| Illinois | IL |
| Indiana | IN |
| Iowa | IA |
| Kansas | KS |
| Kentucky | KY |
| Louisiana | LA |
| Maine | ME |
| Maryland | MD |
| Massachusetts | MA |
| Michigan | MI |
| Minnesota | MN |
| Mississippi | MS |
| Missouri | MO |
| Montana | MT |
| Nebraska | NE |
| Nevada | NV |
| New Hampshire | NH |
| New Jersey | NJ |
| New Mexico | NM |
| New York | NY |
| North Carolina | NC |
| North Dakota | ND |
| Northern Mariana Islands | MP |
| Ohio | OH |
| Oklahoma | OK |
| Oregon | OR |
| Pennsylvania | PA |
| Puerto Rico | PR |
| Rhode Island | RI |
| South Carolina | SC |
| South Dakota | SD |
| Tennessee | TN |
| Texas | TX |
| United States Minor Outlying Islands | UM |
| Utah | UT |
| Vermont | VT |
| Virgin Islands, U.S | VI |
| Virginia | VA |
| Washington | WA |
| West Virginia | WV |
| Wisconsin | WI |
| Wyoming | WY |
Validation rules
- State codes must be provided in uppercase
- The country field must match the state code provided
- Example: "country": "US" with "state": "CA"
- Do not send a state code for unsupported countries
Common mistakes
❌ Providing a state for unsupported countries { "country": "FR", "state": "IDF" }
❌ Using incorrect or lowercase codes { "country": "US", "state": "ca" }
Next steps
- Refer to the Country Codes page for valid country values
- Check the API Reference to confirm which endpoints require state codes
- Validate country and state combinations before sending requests