Themes built on the Twig templating engine are now deprecated and require migration to Vitrin to ensure continued support and compatibility with Zid.

List Cities for Country

GET

https://api.zid.sa/v1/managers/cities/by-country-id/{country_id}

Retrieve a list of cities for a specific country where the store operates or delivers. The list includes each city's unique ID, name, and country details. Note that a city can be labeled as 'Other', represented by an 'أخرى' or 'Other' in the 'name' field, which typically signifies a location outside of the predefined list of cities.

🔑Scopes

countries_cities.read - Countries & Cities Read

Request

Path Params

Header Params

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

curl --location --request GET 'https://api.zid.sa/v1/managers/cities/by-country-id/184' \
--header 'Authorization: {{Autherization}}' \
--header 'X-Manager-Token: {{Access-Token}}' \
--header 'Accept-Language: en'

Responses

🟢200OK

application/json

A list of cities is returned

Body

Example

{
    "status": "object",
    "cities": [
        {
            "name": "Other",
            "id": 1,
            "national_id": 3,
            "priority": 10,
            "country_id": 184,
            "country_name": "السعودية",
            "country_code": "SA",
            "ar_name": "الرياض",
            "en_name": "Riyadh"
        }
    ],
    "message": {
        "type": "object",
        "code": "string",
        "name": "string",
        "description": "string"
    }
}

🟠401Unauthorized

🔴500Internal Server error

Modified at 2026-01-30 20:55:20

List Countries

Overview