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

# Gestion des tags

> GET /tag/list/

Les tags sont les étiquettes rattachées aux QR codes pour le filtrage et le reporting — les mêmes tags affichés sous forme de puces dans toute la liste QR Codes du tableau de bord. Cet endpoint renvoie les tags visibles par le compte authentifié, en lecture seule.

<Note>
  Nécessite une clé Management API avec le quota `MANAGEMENT_API` (ou `MANAGEMENT_API_SANDBOX`), envoyée comme valeur brute de l'en-tête `Authorization`. Voir la [vue d'ensemble de la Management API](/fr/api-reference/management-api/overview).
</Note>

## Lister les tags

<RequestExample>
  ```bash cURL theme={null}
  curl --request GET \
    --url 'https://management.scanova.io/tag/list/' \
    --header 'Authorization: YOUR_API_KEY'
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "count": 1,
    "next": null,
    "previous": null,
    "results": [
      {
        "id": 3369,
        "name": "docs-v2-test-tag"
      }
    ]
  }
  ```
</ResponseExample>

Les résultats sont paginés (taille de page 10 par défaut, jusqu'à 100 via `page_size`).

<ParamField query="name" type="string">
  Correspondance de préfixe insensible à la casse — renvoie les tags dont le nom commence par cette valeur.
</ParamField>

<ParamField query="page" type="integer">
  Numéro de page à récupérer.
</ParamField>

<ParamField query="page_size" type="integer" default="10">
  Nombre de tags par page. Maximum 100.
</ParamField>

### Champs de réponse

<ResponseField name="id" type="integer">
  ID du tag.
</ResponseField>

<ResponseField name="name" type="string">
  Nom du tag, toujours renvoyé en minuscules quelle que soit la façon dont il a été saisi à l'origine.
</ResponseField>

<Note>
  Cette liste se limite aux tags réellement rattachés à (ou pouvant être assignés aux) QR codes propres du compte — ce n'est pas un annuaire de tags global. Si le compte a des [permissions d'utilisateurs partagés basées sur les tags](/fr/team/roles-and-permissions) activées, l'ensemble renvoyé peut en outre dépendre des tags auxquels le compte authentifié est limité.
</Note>

<Warning>
  Il n'existe aucun endpoint de création/suppression correspondant sur la Management API — les tags sont créés implicitement lorsqu'ils sont rattachés à un QR code (via le tableau de bord, les endpoints de création/mise à jour de QR codes, ou les opérations groupées), et non via un appel dédié de gestion des tags.
</Warning>

## Voir aussi

* [Gestion des dossiers](/fr/api-reference/management-api/folders/list) — l'autre mécanisme d'organisation des QR codes, utilisé en complément (ou à la place) des tags.
* [Lister / créer des QR codes](/fr/api-reference/management-api/qr/list) — filtrez les QR codes par nom de tag via `?tags=`.
* [Gestion des utilisateurs partagés](/fr/api-reference/management-api/shared-users/invite) — où un ID de tag de cette liste est utilisé pour limiter la visibilité d'un coéquipier.
* [Rôles et permissions](/fr/team/roles-and-permissions) — comment fonctionne la limitation des permissions basée sur les tags côté tableau de bord.


## OpenAPI

````yaml api-reference/openapi/management-api.json GET /tag/list/
openapi: 3.1.0
info:
  title: Scanova Management API (v2)
  description: >-
    The complete Scanova Management API — every endpoint available at
    management.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://management.scanova.io
    description: Management API — QR/folder/tag/lead/form/analytics/plans endpoints
security:
  - apiKeyAuth: []
paths:
  /tag/list/:
    get:
      summary: List tags
      operationId: listManagedTags
      responses:
        '200':
          description: List of tags
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. management.scanova.io) — the same key sent to
        the regular API host will not authenticate.

````