> ## 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.

# Récupérer un thème

> GET /theme/{slug}/

Récupère un thème par slug ou id, sur l'hôte de l'**API de gestion** (`api.scanova.io`), authentifié avec votre clé d'API de gestion brute.

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

<ParamField path="slug" type="string" required>
  Le `slug` du thème (un `id` numérique fonctionne aussi avec cette même forme de chemin).
</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>
  Aucune vérification de propriété ne s'applique ici — n'importe quel thème actif, y compris celui d'un autre compte, peut être récupéré par slug ou id, les thèmes étant une ressource en lecture partagée pour le créateur de pages. L'écriture dans un thème que vous ne possédez pas reste néanmoins bloquée — voir [Mettre à jour un thème](/fr/api-reference/management-api/theme-manager/theme-update).
</Note>

`404` si `slug` ne correspond à aucun thème actif.

## Voir aussi

* [Lister les thèmes](/fr/api-reference/management-api/theme-manager/theme-list) — parcourir tous les thèmes.
* [Mettre à jour un thème](/fr/api-reference/management-api/theme-manager/theme-update) — modifier ce thème, si vous le possédez.
* [Obtenir les statistiques d'utilisation d'un thème](/fr/api-reference/management-api/theme-manager/theme-usage) — voir ce qui l'utilise.
* [Présentation de l'API de gestion](/fr/api-reference/management-api/overview) — le schéma d'authentification et les règles de quota applicables à cet endpoint.


## 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.

````