Get US States

GET/web/v1/system/constants/us-states None

Required Gateway Headers

All API requests require gateway headers. See Required Headers for the complete list. In local/test environments, you must also include Cloudflare simulation headers (CF-Connecting-IP, Cf-Ray, cf-ipcountry).

Returns a list of all US states with ISO 3166-2 codes. The response is localized based on the Accept-Language request header.

Authentication

No authentication required. This is a public endpoint.

Request Parameters

None.

Success Response

Success 200

{
  "code": "2000",
  "message": "SUCCESS",
  "data": [
    {
      "code": "CA",
      "value": 95010405,
      "label": "California",
      "description": "State of California",
      "isoCode": "CA"
    },
    {
      "code": "NY",
      "value": 95010432,
      "label": "New York",
      "description": "State of New York",
      "isoCode": "NY"
    }
  ]
}

Response Fields

Name	Type	Required	Description
code	string	Required	Enum name identifier (e.g., "CA")
value	integer	Required	8-digit numeric code for API usage
label	string	Required	Localized display name based on Accept-Language header
description	string	Required	Localized human-readable description of the US state
isoCode	string	Required	ISO 3166-2 subdivision code (e.g., "CA")

Error Responses

HTTP Status	Code	Message	Description
500	"5000"	"INTERNAL_SERVER_ERROR"	Unexpected server error

Notes

• The label field is localized; send Accept-Language: zh-CN for Chinese labels.