> ## Documentation Index
> Fetch the complete documentation index at: https://docs.scanova.io/llms.txt
> Use this file to discover all available pages before exploring further.

# الحصول على سمة

> GET /theme/{slug}/

يحصل على سمة واحدة عبر السمة (slug) أو المعرّف، على مضيف **Management API** (‏`api.scanova.io`‏)، مع المصادقة باستخدام مفتاح Management API الخام الخاص بك.

```
GET https://api.scanova.io/theme/{slug}/
Authorization: 401f7ac837da42b97f613d789819ff93537bee6a
```

<ParamField path="slug" type="string" required>
  سمة (slug) الخاصة بالسمة (معرّف `id` رقمي يعمل أيضًا بنفس شكل المسار).
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.scanova.io/theme/user-42-ocean-breeze-a1b2c3/" \
    -H "Authorization: 401f7ac837da42b97f613d789819ff93537bee6a"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "id": 7,
    "name": "Ocean Breeze",
    "slug": "user-42-ocean-breeze-a1b2c3",
    "description": "A cool blue palette.",
    "config_json": { "color": { "accent": "#0077be", "background": "#f0f8ff" }, "font": { "heading": "Inter" } },
    "schema_version": 2,
    "category_hints": ["website-url", "vcard"],
    "thumbnail_url": "https://cdn.scanova.io/themes/7/thumb.png",
    "is_system": false,
    "is_premium": false,
    "order": 0
  }
  ```
</ResponseExample>

<Note>
  لا يُطبَّق أي فحص للملكية هنا — يمكن الحصول على أي سمة نشطة، بما في ذلك سمة حساب آخر، عبر السمة (slug) أو المعرّف، لأن السمات مورد مشترك للقراءة لمنشئ الصفحات. تظل الكتابة في سمة لا تملكها محظورة — راجع [تحديث سمة](/ar/api-reference/management-api/theme-manager/theme-update).
</Note>

يُعاد `404` إذا لم تطابق `slug` أي سمة نشطة.

## ذات صلة

* [سرد السمات](/ar/api-reference/management-api/theme-manager/theme-list) — تصفح جميع السمات.
* [تحديث سمة](/ar/api-reference/management-api/theme-manager/theme-update) — تعديل هذه السمة، إذا كنت تملكها.
* [الحصول على أعداد استخدام سمة](/ar/api-reference/management-api/theme-manager/theme-usage) — الاطلاع على ما يستخدمها.
* [نظرة عامة على Management API](/ar/api-reference/management-api/overview) — مخطط المصادقة وقواعد الحصة المطبّقة على نقطة النهاية هذه.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /theme/{slug}/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    api.scanova.io (QR codes, folders, tags, leads, forms, analytics, plans,
    shared users & roles), plus the token-creation and usage-stats endpoints
    used to authenticate against it. Every path and request/response shape below
    was verified live against a real API key and the actual running backend
    (Phase 7, 2026-08-16) — not guessed from reading urls.py alone.
  version: 2.0.0
servers:
  - url: https://api.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /theme/{slug}/:
    get:
      summary: Retrieve a theme
      description: >-
        Looked up by `slug` (a numeric `pk` also works at the same path shape).
        No ownership check — any active theme, including another account's, can
        be retrieved by slug/id, since themes are shared-read for the page
        builder.
      operationId: getTheme
      parameters:
        - name: slug
          in: path
          required: true
          schema:
            type: string
      responses:
        '200':
          description: One theme.
          content:
            application/json:
              example:
                id: 7
                name: Ocean Breeze
                slug: user-42-ocean-breeze-a1b2c3
                description: A cool blue palette.
                config_json:
                  color:
                    accent: '#0077be'
                    background: '#f0f8ff'
                  font:
                    heading: Inter
                schema_version: 2
                category_hints:
                  - website-url
                  - vcard
                thumbnail_url: https://cdn.scanova.io/themes/7/thumb.png
                is_system: false
                is_premium: false
                order: 0
        '404':
          description: No active theme with this slug/id.
components:
  securitySchemes:
    apiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Send your Management API key as the raw value of the Authorization
        header — no "Bearer " or "Token " prefix, and no other characters.
        Example: `Authorization: 401f7ac837da42b97f613d789819ff93537bee6a`. A
        header containing more than one space-separated part is rejected
        outright. Requests also require the request's Host header to be the
        management API host (e.g. api.scanova.io) — the same key sent to the
        regular API host will not authenticate.

````