Skip to main content
GET
Get cities by state

Request

Headers

Query parameters

Request examples

Nigerian cities

United States cities

United Kingdom cities

Successful response

Error responses

400 Bad Request

404 Not Found

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.

state
string
required

State/region name to retrieve cities for.

Response

Cities retrieved successfully.

status
integer
Example:

200

success
boolean
Example:

true

message
string
Example:

"Cities retrieved"

data
string[]
Example: