Salla Docs
Merchant API
Partner APIs
Storefront
Salla CLI
Salla Docs
    Light Mode

    List Cities

    GET/countries/{country}/cities
    Last modified: a month ago

    This endpoint allows you to list all available cities for a specific country by passing the country as a path parameter.

    :::note
    Country details will also be returned in the payload.
    :::

    `metadata.read`- Metadata Read Only

    Request

    Path Params
    country
    integer 
    required

    The Country ID. List of Country IDs from here

    Query Params
    page
    integer 
    optional

    The Pagination page number

    Request samples

    Responses

    Success(200)
    Not Found(404)
    HTTP Code: 200
    Content Type : JSONapplication/json
    Data Schema
    No schema defined
    Example
    {
      "status": 200,
      "success": true,
      "data": [
        {
          "id": 1,
          "name": "الرياض",
          "name_en": "Riyadh",
          "country_id": 1473353380
        },
        {
          "id": 2,
          "name": "جدة",
          "name_en": "Jeddah",
          "country_id": 1473353380
        },
        {
          "id": 3,
          "name": "مكة",
          "name_en": "Mecca",
          "country_id": 1473353380
        },
        {
          "id": 4,
          "name": "المدينة المنورة",
          "name_en": "Medina",
          "country_id": 1473353380
        },
        {
          "id": 5,
          "name": "الدمام",
          "name_en": "Dammam",
          "country_id": 1473353380
        },
        {
          "id": 6,
          "name": "الأحساء",
          "name_en": "Al Ahsa",
          "country_id": 1473353380
        },
        {
          "id": 7,
          "name": "القطيف",
          "name_en": "Al Qatif",
          "country_id": 1473353380
        },
        {
          "id": 8,
          "name": "خميس مشيط",
          "name_en": "Khamis Mushait",
          "country_id": 1473353380
        },
        {
          "id": 9,
          "name": "المظيلف",
          "name_en": "Almuzaylif",
          "country_id": 1473353380
        },
        {
          "id": 10,
          "name": "تبوك",
          "name_en": "Tabuk",
          "country_id": 1473353380
        },
        {
          "id": 11,
          "name": "الهفوف",
          "name_en": "Al Hofuf",
          "country_id": 1473353380
        },
        {
          "id": 12,
          "name": "المبرز",
          "name_en": "Al Mubarraz",
          "country_id": 1473353380
        },
        {
          "id": 13,
          "name": "نجران",
          "name_en": "Najran",
          "country_id": 1473353380
        },
        {
          "id": 14,
          "name": "حفر الباطن",
          "name_en": "Hafar Al Batin",
          "country_id": 1473353380
        },
        {
          "id": 15,
          "name": "الجبيل",
          "name_en": "Al Jubail",
          "country_id": 1473353380
        }
      ],
      "country": {
        "id": 1473353380,
        "name": "السعودية",
        "code": "SA"
      },
      "pagination": {
        "count": 15,
        "total": 716,
        "perPage": 15,
        "currentPage": 1,
        "totalPages": 48,
        "links": {
          "next": "https://api.salla.dev/admin/v2/countries/1473353380/cities?page=2"
        }
      }
    }
    Last modified: a month ago