Operators API

Manage and browse telecom operators (STC, Mobily, Zain).

---

GET /operators

List all active telecom operators with Arabic and English names.

Example Request

GET /operators
Accept-Language: en

Response

200 OK

{
  "data": [
    {
      "id": "f47ac10b-58cc-4372-a567-0e02b2c3d479",
      "slug": "stc",
      "nameEn": "Saudi Telecom Company",
      "nameAr": "شركة الاتصالات السعودية",
      "logoUrl": "https://<cdn-origin>/logos/stc.png",
      "packageCount": 0,
      "supportsEsim": true,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    },
    {
      "id": "a3b4c5d6-e7f8-9012-abcd-ef2345678901",
      "slug": "mobily",
      "nameEn": "Mobily",
      "nameAr": "موبايلي",
      "logoUrl": "https://<cdn-origin>/logos/mobily.png",
      "packageCount": 0,
      "supportsEsim": false,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    },
    {
      "id": "b4c5d6e7-f8a9-0123-bcde-f34567890123",
      "slug": "zain",
      "nameEn": "Zain",
      "nameAr": "زين",
      "logoUrl": "https://<cdn-origin>/logos/zain.png",
      "packageCount": 0,
      "supportsEsim": false,
      "createdAt": "2026-01-01T00:00:00.000Z",
      "updatedAt": "2026-01-01T00:00:00.000Z"
    }
  ]
}

packageCount returns 0 until the package counting query is implemented. Both nameEn and nameAr are always returned so the client can choose the display language.

Operator Slugs

Slug	Operator	Arabic
stc	Saudi Telecom Company	شركة الاتصالات السعودية
mobily	Mobily	موبايلي
zain	Zain	زين

The operators table also holds eSIM store providers with serviceType='esim'. This endpoint serves telecom rows only.