---
title: "Liste des périmètres génériques activés sur le serveur"
method: GET
path: "/generic/scopes"
tags: ["Générique"]
---

# Liste des périmètres génériques activés sur le serveur

`GET /generic/scopes`

## Request

- Base URL: `https://ecobalyse.beta.gouv.fr/api`
- URL: `https://ecobalyse.beta.gouv.fr/api/generic/scopes`
- Auth: API key in header `token`

Retourne les périmètres (*scopes*) du calculateur générique disponibles sur cette instance.

Utiliser les identifiants renvoyés comme valeur du paramètre de chemin `{scope}`
des autres points d’accès génériques. Un appel vers un périmètre absent de cette
liste renvoie une erreur HTTP 403.

## Response `200`

Opération réussie

- object[]: Liste des périmètres génériques activés sur cette instance (voir `GET /generic/scopes`).
  - `id` string, required: Identifiant utilisable comme paramètre de chemin `{scope}`.
  - `name` string, required: Libellé affichable du périmètre.

## Other responses

- `401`: Jeton d’API manquant ou invalide
- `403`: Accès refusé ; cela peut être dû à un scope désactivé sur cette instance, ou à un compte non autorisé (par exemple, accès réservé aux bêta-testeurs et superutilisateurs)
- `500`: Erreur irrécupérable du serveur

## Changes

- **2026-10-15** `811ec3300dbe`: 3 info
  - added the media type `application/json` for the response with the status `401`
  - added the media type `application/json` for the response with the status `403`
  - added the non-success response with the status `500`
- **2026-09-22** `c6595cf5feef`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/betagouv/apis/api-ecobalyse/changes/generic/scopes/get.md)

---

[API](https://skmtc.dev/betagouv/apis/api-ecobalyse.md) - [All operations](https://skmtc.dev/betagouv/apis/api-ecobalyse/llms.txt) - [OpenAPI document](https://skmtc.dev/betagouv/apis/api-ecobalyse/revisions/53c2de0c8ef0?raw)