Reference

List cities

The cities of one state.

GET/v1/states/{stateId}/cities

Bearer tokenReturns JSONSuccess 200

Sorted by name. Send search with at least two letters to narrow the list. Delivery is only possible to a city the shipping company covers; an order to any other city is refused when it is created.

Request

Headers

Field	Type	Description
`Authorization`required	`string`	The access token from Get token, as "Bearer <token>".

Path parameters

Field	Type	Description
`stateId`required	`string`	The state's id, from List states.

Query parameters

Field	Type	Description
`search`optional	`string`	Narrow the list by name. At least two letters.
`limit`optional	`number`	The most rows to return, 1 to 500. Default 100.

Example request

curl -X GET "https://api.swiftazu.com/v1/states/73ff99bd-ca0e-4ec7-a60e-f314c57c0046/cities" \
  -H "Authorization: Bearer YOUR_ACCESS_TOKEN"

Response

Example response · 200

[
  {
    "id": "23a058c2-9b96-460b-92d8-1196cba2f562",
    "name": "Dubai",
    "nameAr": "دبي",
    "countryId": "cfde4319-9563-4d6a-9afa-0f72dad3c718",
    "stateId": "73ff99bd-ca0e-4ec7-a60e-f314c57c0046"
  }
]

Errors

HTTP	Code	Meaning
404	`state_not_found`	No state has this id.

Every call can also return the shared errors listed on the Overview page. Overview