Countries

This guide explains how to interact with the Countries API in the Sumaya369.

List Countries

Endpoint

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

Request Headers

Header	Value	Required
Content-Type	application/json	Yes
Accept	application/json	Yes

Query Parameters

Parameter	Type	Description	Required
per_page	integer	Number of countries per page (default: 10)	No
list	boolean	Return simplified list format	No
select_country	boolean	Include user's current country based on IP (default: Saudi Arabia)	No
search_text	string	Search in country name and short name	No
priority	true	Filter by priority	No
orderBy	string	Sort field (default: short_name)	No

Success Response (List Format)

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "countries": [
            {
                "id": "18e1ceab-f28a-4fcc-929f-526b8f6e1557",
                "name": "السعودية",
                "phone_code": "+966",
                "selected": false
            },
            {
                "id": "baf72ad4-7d31-4ba0-ac4f-df292ba7133a",
                "name": "الإمارات",
                "phone_code": "+971",
                "selected": false
            },
            {
                "id": "ee336268-8656-4378-80d9-5e5e0f01e5dd",
                "name": "الكويت",
                "phone_code": "+965",
                "selected": false
            },
            {
                "id": "a902c239-6de9-457c-ab0d-0f9d2c6a520f",
                "name": "العراق",
                "phone_code": "+964",
                "selected": false
            },
            {
                "id": "c5172f20-b432-4db1-a32d-ba2f24b83054",
                "name": "الجزائر",
                "phone_code": "+213",
                "selected": false
            },
            {
                "id": "515b13a7-9481-4a2c-814f-35d320c271e5",
                "name": "عمان",
                "phone_code": "+968",
                "selected": false
            },
            {
                "id": "f68eb068-be2a-421f-823f-186a1d40a0e2",
                "name": "المغرب",
                "phone_code": "+212",
                "selected": false
            },
            {
                "id": "7ae28c87-6c08-4d5f-bbf3-7548defeac7f",
                "name": "السودان",
                "phone_code": "+249",
                "selected": false
            },
            {
                "id": "47d1d1c3-c6bd-43dc-97b9-cb244eff9afe",
                "name": "البحرين",
                "phone_code": "+973",
                "selected": false
            },
            {
                "id": "37052f43-7a5d-4211-b920-f938b9a57b19",
                "name": "مصر",
                "phone_code": "+20",
                "selected": false
            },
            {
                "id": "96935556-d930-455a-8099-98c9dbd6ee70",
                "name": "قطر",
                "phone_code": "+974",
                "selected": false
            },
        ]
    },
    "status_code": 200
}

Success Response (Paginated Format)

{
    "success": true,
    "message": "تم جلب البيانات بنجاح.",
    "data": {
        "current_page": 1,
        "first_page_url": "http://192.168.0.139:8080/v1/admin/countries?page=1",
        "from": 1,
        "last_page": 25,
        "last_page_url": "http://192.168.0.139:8080/v1/admin/countries?page=25",
        "links": [
            {
                "url": null,
                "label": "« السابق",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=1",
                "label": "1",
                "active": true
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=2",
                "label": "2",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=3",
                "label": "3",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=4",
                "label": "4",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=5",
                "label": "5",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=6",
                "label": "6",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=7",
                "label": "7",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=8",
                "label": "8",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=9",
                "label": "9",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=10",
                "label": "10",
                "active": false
            },
            {
                "url": null,
                "label": "...",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=24",
                "label": "24",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=25",
                "label": "25",
                "active": false
            },
            {
                "url": "http://192.168.0.139:8080/v1/admin/countries?page=2",
                "label": "التالي »",
                "active": false
            }
        ],
        "next_page_url": "http://192.168.0.139:8080/v1/admin/countries?page=2",
        "path": "http://192.168.0.139:8080/v1/admin/countries",
        "per_page": 10,
        "prev_page_url": null,
        "to": 10,
        "total": 249,
        "countries": [
            {
                "id": "9dd4de52-4c4a-40d1-8e85-151a6ab2310e",
                "name": "جزر بيتكيرن",
                "phone_code": "+872"
            },
            {
                "id": "5aec82ba-e9e0-4517-9213-3dece54e5827",
                "name": "رومانيا",
                "phone_code": "+40"
            },
            {
                "id": "22137252-cc11-4bd0-900d-aa886e6b143f",
                "name": "بالاو",
                "phone_code": "+680"
            },
            {
                "id": "c6ea122b-bea3-465b-ab90-6628f9493209",
                "name": "كاليدونيا الجديدة",
                "phone_code": "+687"
            },
            {
                "id": "6c5b06b4-24d5-4c0a-86f2-2b4d449ed08a",
                "name": "كوريا الشمالية",
                "phone_code": "+850"
            },
            {
                "id": "0f81805d-0f13-4b0f-a171-924c6bf2ca98",
                "name": "نييوي",
                "phone_code": "+683"
            },
            {
                "id": "9aa06167-3b5b-4983-a01b-ee8eb716d154",
                "name": "جزر الولايات المتحدة الصغيرة النائية",
                "phone_code": ""
            },
            {
                "id": "648eb126-472d-47e4-bef1-fd2b9893fd24",
                "name": "غيانا",
                "phone_code": "+595"
            },
            {
                "id": "6abf770a-4f1a-4430-bd6d-0270c3382438",
                "name": "باكستان",
                "phone_code": "+92"
            },
            {
                "id": "2150c663-d491-4d1e-8511-e61a7dee9f97",
                "name": "بوركينا فاسو",
                "phone_code": "+226"
            }
        ]
    },
    "status_code": 200
}

Notes

• Response caching is implemented for better performance
• Default sorting is by priority and then short name
• Saudi Arabia (SA) is set as the default selected country when requested and no geolocation service is available. (currently disabled)
• Selected country only works when list=true is used, otherwise it won't appear in the paginated result.
• Supports both list and paginated response formats
• Includes phone codes for international calling