Skip to main content
GET
Get states by country

Request

Headers

Query parameters

Request examples

Get Nigerian states (default)

Get US states

Get UK states

Successful response

Error response

Authorizations

Authorization
string
header
required

JWT issued by the Salesive Store API for authenticated shoppers.

x-shop-id
string
header
required

Optional storefront identifier sent as a header to scope responses to a specific shop. Try It requests remember this value once provided.

Headers

x-shop-id
string

Optional identifier that scopes responses to a specific storefront when the referer cannot be inferred.

Query Parameters

shortName
string
default:NG

Country short name (e.g., NG, US, GB). Defaults to NG if not provided.

Response

States retrieved successfully.

status
integer
Example:

200

success
boolean
Example:

true

message
string
Example:

"States retrieved"

data
string[]
Example: