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

List Countries

GET

https://api.zid.sa/v1/settings/countries

The endpoint returns all countries' names, codes, and IDs, and is not specific to any particular store's operations or merchant's activated countries.

🔑Scopes

countries_cities.read - Countries & Cities Read

Request

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/settings/countries' \
--header 'Accept: application/json' \
--header 'Authorization: {{Autherization}}' \
--header 'Accept-Language: en'

Responses

🟢200OK

application/json

Body

Example

{
    "status": "string",
    "countries": [
        {
            "id": 184,
            "name": "السعودية",
            "code": "SA",
            "country_code": "SAU",
            "flag": "https://media.zid.store/static/sa.svg"
        }
    ],
    "message": {
        "type": "string",
        "code": "string",
        "name": "string",
        "description": "string"
    }
}

🟠401Unauthorized

Modified at 2026-01-26 12:50:48

Countries and Cities

List Cities for Country