1. User Registration
Game Loom
  • Game Loom
    • 👋 Welcome to Game Loom
  • Getting started
    • Introduction
    • 👤 Authentication
  • User Registration
    • Introduction
    • Get Countries
      GET
    • Get Cities
      GET
    • Single user registration
      POST
    • Bulk Register Users
      POST
  • Notifications
    • Overview
    • Receiving Event Notifications via Webhooks
    • Get All notifications for specific user
      GET
  • Rewards
    • Overview
    • Points
      • Record user point event
      • Get user points
      • Get Specific user point
    • Levels
      • Record user level event
      • Get user levels
      • Get Specific user level
    • Badges
      • Award badge to user
      • Get user badges
      • Get Specific user badge
  • Challenges (Gamification elements)
    • Introduction
    • Leaderboard
      • Get available leaderboards for user
      • Submit score to a leaderboard
      • Get user's leaderboard participation history
      • Get leaderboard details
      • Get leaderboard ranking
      • Get user's record for a leaderboard
      • Get user's entry history for a leaderboard
    • Survey
      • Overview
      • Get available surveys for user
      • Start a new survey participation
      • Get detailed user participation
      • Get user's survey participation history
      • Abandon survey participation
      • Save individual answer to survey question
      • Submit completed survey
      • Submit Survey with answers (One-Step Submission)
    • Quiz
      • Get available quizzes for user
      • Submit complete quiz answers
      • Get comprehensive user quiz history
      • Get comprehensive quiz attempt details
    • Open Challenge
      • Overview
      • Get available open challenges for user
      • Complete an open challenge
      • Get user's open challenge participation history
      • Get user open challenge by ID
    • Schemas
      • Survey Schame
  1. User Registration

Get Cities

GET
api/v1/lookups/cities/{countryId}
Returns the list of cities for a given country. The countryId path parameter must be a valid ISO 3166-1 alpha-2 country code (e.g. SA, EG). Each city includes a LookupId (composite slug in the format {countryCode}-{city-slug}), English and Arabic names, and the parent CountryId. Use the LookupId value as the city field when registering a user.

Request

Path Params

Header Params

Responses

🟢200Success
application/json
Body

Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://api-stg.98s.studio/api/v1/lookups/cities/SA' \
--header 'x-api-key: {{api-key}}'
Response Response Example
SA - Example
[
    {
        "id": "SA-abha",
        "nameEn": "Abha",
        "nameAr": "أبها"
    },
    {
        "id": "SA-abu-arish",
        "nameEn": "Abu Arish",
        "nameAr": "أبو عريش"
    },
    {
        "id": "SA-afif",
        "nameEn": "Afif",
        "nameAr": "عفيف"
    },
    {
        "id": "SA-ahad-al-masarihah",
        "nameEn": "Ahad Al Masarihah",
        "nameAr": "أحد المسارحة"
    },
    {
        "id": "SA-al-aflaj",
        "nameEn": "Al Aflaj",
        "nameAr": "الأفلاج"
    },
    {
        "id": "SA-al-baha",
        "nameEn": "Al Baha",
        "nameAr": "الباحة"
    },
    {
        "id": "SA-al-bukayriyah",
        "nameEn": "Al Bukayriyah",
        "nameAr": "البكيرية"
    },
    {
        "id": "SA-al-darb",
        "nameEn": "Al Darb",
        "nameAr": "الدرب"
    },
    {
        "id": "SA-al-diriyah",
        "nameEn": "Al Diriyah",
        "nameAr": "الدرعية"
    },
    {
        "id": "SA-al-ghat",
        "nameEn": "Al Ghat",
        "nameAr": "الغاط"
    },
    {
        "id": "SA-al-hofuf",
        "nameEn": "Al Hofuf",
        "nameAr": "الهفوف"
    },
    {
        "id": "SA-al-khafji",
        "nameEn": "Al Khafji",
        "nameAr": "الخفجي"
    },
    {
        "id": "SA-al-khobar",
        "nameEn": "Al Khobar",
        "nameAr": "الخبر"
    },
    {
        "id": "SA-al-lith",
        "nameEn": "Al Lith",
        "nameAr": "الليث"
    },
    {
        "id": "SA-al-majmaah",
        "nameEn": "Al Majmaah",
        "nameAr": "المجمعة"
    },
    {
        "id": "SA-al-mubarraz",
        "nameEn": "Al Mubarraz",
        "nameAr": "المبرز"
    },
    {
        "id": "SA-al-namas",
        "nameEn": "Al Namas",
        "nameAr": "النماص"
    },
    {
        "id": "SA-al-qatif",
        "nameEn": "Al Qatif",
        "nameAr": "القطيف"
    },
    {
        "id": "SA-al-qurayyat",
        "nameEn": "Al Qurayyat",
        "nameAr": "القريات"
    },
    {
        "id": "SA-al-ula",
        "nameEn": "Al Ula",
        "nameAr": "العلا"
    },
    {
        "id": "SA-al-wajh",
        "nameEn": "Al Wajh",
        "nameAr": "الوجه"
    },
    {
        "id": "SA-al-zulfi",
        "nameEn": "Al Zulfi",
        "nameAr": "الزلفي"
    },
    {
        "id": "SA-arar",
        "nameEn": "Arar",
        "nameAr": "عرعر"
    },
    {
        "id": "SA-as-sulayyil",
        "nameEn": "As Sulayyil",
        "nameAr": "السليل"
    },
    {
        "id": "SA-badr",
        "nameEn": "Badr",
        "nameAr": "بدر"
    },
    {
        "id": "SA-bisha",
        "nameEn": "Bisha",
        "nameAr": "بيشة"
    },
    {
        "id": "SA-buraidah",
        "nameEn": "Buraidah",
        "nameAr": "بريدة"
    },
    {
        "id": "SA-dammam",
        "nameEn": "Dammam",
        "nameAr": "الدمام"
    },
    {
        "id": "SA-dawadmi",
        "nameEn": "Dawadmi",
        "nameAr": "الدوادمي"
    },
    {
        "id": "SA-dhahran",
        "nameEn": "Dhahran",
        "nameAr": "الظهران"
    },
    {
        "id": "SA-domat-al-jandal",
        "nameEn": "Domat Al Jandal",
        "nameAr": "دومة الجندل"
    },
    {
        "id": "SA-duba",
        "nameEn": "Duba",
        "nameAr": "ضبا"
    },
    {
        "id": "SA-hafar-al-batin",
        "nameEn": "Hafar Al Batin",
        "nameAr": "حفر الباطن"
    },
    {
        "id": "SA-hail",
        "nameEn": "Hail",
        "nameAr": "حائل"
    },
    {
        "id": "SA-haql",
        "nameEn": "Haql",
        "nameAr": "حقل"
    },
    {
        "id": "SA-hotat-bani-tamim",
        "nameEn": "Hotat Bani Tamim",
        "nameAr": "حوطة بني تميم"
    },
    {
        "id": "SA-jeddah",
        "nameEn": "Jeddah",
        "nameAr": "جدة"
    },
    {
        "id": "SA-jizan",
        "nameEn": "Jizan",
        "nameAr": "جازان"
    },
    {
        "id": "SA-jubail",
        "nameEn": "Jubail",
        "nameAr": "الجبيل"
    },
    {
        "id": "SA-khamis-mushait",
        "nameEn": "Khamis Mushait",
        "nameAr": "خميس مشيط"
    },
    {
        "id": "SA-kharj",
        "nameEn": "Kharj",
        "nameAr": "الخرج"
    },
    {
        "id": "SA-khaybar",
        "nameEn": "Khaybar",
        "nameAr": "خيبر"
    },
    {
        "id": "SA-king-abdullah-economic-city",
        "nameEn": "King Abdullah Economic City",
        "nameAr": "مدينة الملك عبدالله الاقتصادية"
    },
    {
        "id": "SA-marat",
        "nameEn": "Marat",
        "nameAr": "مرات"
    },
    {
        "id": "SA-mecca",
        "nameEn": "Mecca",
        "nameAr": "مكة المكرمة"
    },
    {
        "id": "SA-medina",
        "nameEn": "Medina",
        "nameAr": "المدينة المنورة"
    },
    {
        "id": "SA-muhayil",
        "nameEn": "Muhayil",
        "nameAr": "محايل عسير"
    },
    {
        "id": "SA-muzahmiyya",
        "nameEn": "Muzahmiyya",
        "nameAr": "المزاحمية"
    },
    {
        "id": "SA-neom",
        "nameEn": "NEOM",
        "nameAr": "نيوم"
    },
    {
        "id": "SA-najran",
        "nameEn": "Najran",
        "nameAr": "نجران"
    },
    {
        "id": "SA-qunfudhah",
        "nameEn": "Qunfudhah",
        "nameAr": "القنفذة"
    },
    {
        "id": "SA-rabigh",
        "nameEn": "Rabigh",
        "nameAr": "رابغ"
    },
    {
        "id": "SA-rafha",
        "nameEn": "Rafha",
        "nameAr": "رفحاء"
    },
    {
        "id": "SA-ras-tanura",
        "nameEn": "Ras Tanura",
        "nameAr": "رأس تنورة"
    },
    {
        "id": "SA-rass",
        "nameEn": "Rass",
        "nameAr": "الرس"
    },
    {
        "id": "SA-riyadh",
        "nameEn": "Riyadh",
        "nameAr": "الرياض"
    },
    {
        "id": "SA-rumah",
        "nameEn": "Rumah",
        "nameAr": "رماح"
    },
    {
        "id": "SA-sabya",
        "nameEn": "Sabya",
        "nameAr": "صبيا"
    },
    {
        "id": "SA-sakaka",
        "nameEn": "Sakaka",
        "nameAr": "سكاكا"
    },
    {
        "id": "SA-samtah",
        "nameEn": "Samtah",
        "nameAr": "صامطة"
    },
    {
        "id": "SA-shaqra",
        "nameEn": "Shaqra",
        "nameAr": "شقراء"
    },
    {
        "id": "SA-sharurah",
        "nameEn": "Sharurah",
        "nameAr": "شرورة"
    },
    {
        "id": "SA-tabarjal",
        "nameEn": "Tabarjal",
        "nameAr": "طبرجل"
    },
    {
        "id": "SA-tabuk",
        "nameEn": "Tabuk",
        "nameAr": "تبوك"
    },
    {
        "id": "SA-taif",
        "nameEn": "Taif",
        "nameAr": "الطائف"
    },
    {
        "id": "SA-tayma",
        "nameEn": "Tayma",
        "nameAr": "تيماء"
    },
    {
        "id": "SA-thadiq",
        "nameEn": "Thadiq",
        "nameAr": "ثادق"
    },
    {
        "id": "SA-thuwal",
        "nameEn": "Thuwal",
        "nameAr": "ثول"
    },
    {
        "id": "SA-turaif",
        "nameEn": "Turaif",
        "nameAr": "طريف"
    },
    {
        "id": "SA-turbah",
        "nameEn": "Turbah",
        "nameAr": "تربة"
    },
    {
        "id": "SA-unaizah",
        "nameEn": "Unaizah",
        "nameAr": "عنيزة"
    },
    {
        "id": "SA-wadi-al-dawasir",
        "nameEn": "Wadi Al Dawasir",
        "nameAr": "وادي الدواسر"
    },
    {
        "id": "SA-yanbu",
        "nameEn": "Yanbu",
        "nameAr": "ينبع"
    }
]
Modified at 2026-03-17 04:07:16
Previous
Get Countries
Next
Single user registration
Built with