Skip to main content

Countries List

This section covers the endpoints for retrieving country information.

Available Endpoints​

List Countries​

Get a list of all available countries.

Endpoint​

  • Method: GET
  • URL: /v1/coach/countries

Request Headers​

HeaderValueRequired
Content-Typeapplication/jsonYes
Acceptapplication/jsonYes

Success Response​

{
    "success": true,
    "message": "تم جلب البيانات بنجاح",
    "data": {
        "countries": [
            {
                "id": "uuid",
                "name": "السعودية",
                "phoneCode": "+966"
            },
        ]
    },
    "statusCode": 200
}

Overview​

Country Information​

Each country entry includes:

  • Unique identifier
  • Country name
  • Country code (ISO 2-letter code)
  • Phone code for international dialing
  • Active status
  • Creation and update timestamps

Important Notes​

  • Countries are sorted alphabetically by name
  • Only active countries are returned
  • Country codes follow ISO 3166-1 alpha-2 standard
  • Phone codes include the '+' prefix
  • Country data is cached for better performance
  • Updates to country data are managed through admin panel