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

# Lister les panels

> Parcourir le catalogue de panels

Renvoie les panels que ta clé API peut associer via [Ajouter des panels](https://docs.anivahealth.com/fr/api/appointments/add-panels.md).
Requiert le scope `panels_access`. L'objet `pricing` requiert aussi le scope `prices_view`.

> [!NOTE]
>
> Compte `biomarker_groups` pour savoir combien de résultats renvoie une prise de sang. Un groupe
> liste des biomarqueurs interchangeables (hs-CRP *ou* CRP), et le laboratoire n'en mesure qu'un
> seul.

## Requête

### Paramètres de requête

**rate\_card** `string`

La grille tarifaire pour `price_cents` : `retail`, ou un `id` de grille tarifaire obtenu via [Obtenir la grille
tarifaire](https://docs.anivahealth.com/fr/api/pricing/get-rate-card.md). Utilise par défaut la grille de ton compte de facturation, sinon le tarif public.
`retail_cents` utilise toujours le tarif public.

## Réponse

Renvoie un tableau de panels.

**id** `string`

UUID du panel. Passe-le à [Ajouter des panels](https://docs.anivahealth.com/fr/api/appointments/add-panels.md).

**name** `string`

Nom affiché.

**description** `string | null`

À quoi sert le panel, ou `null`.

**biomarker\_ids** `number[]`

Tous les biomarqueurs de `biomarker_groups` dans une seule liste. Voir [Lister les
biomarqueurs](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md).

**biomarker\_groups** `object[]`

Les groupes requis par le panel. Vide pour le panel personnalisé : ajoute ses biomarqueurs avec [Ajouter
des biomarqueurs individuels](https://docs.anivahealth.com/fr/api/appointments/add-individual-biomarkers.md).

**groupe**

**biomarker\_ids** `number[]`

Biomarqueurs interchangeables. Le laboratoire mesure l'un d'eux.

**required** `boolean`

Toujours `true` pour ta clé.

**inclusion\_condition** `string | null`

Qui reçoit le groupe, par exemple `sex=2` ou `age>50`, combinés avec `&&` ou `||`. `sex` suit la norme
ISO/IEC 5218 (1 masculin, 2 féminin). `null` signifie tout le monde. [Prévisualiser un
rendez-vous](https://docs.anivahealth.com/fr/api/appointments/preview-containers.md) l'applique à un patient.

**pricing** `object | null`

Le prix sur ta grille et au tarif public. Voir [objets de
prix](https://docs.anivahealth.com/fr/api/biomarkers/list-biomarkers.md#objets-de-prix). `null` quand ta clé n'a pas
`prices_view`. `price_cents` est `null` pour le panel personnalisé.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Requête invalide, par exemple un `rate_card` inconnu. |
| `403` | Scope `panels_access` manquant. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/panels' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
    "name": "Hormones (Female)",
    "description": "Cycle-related hormones for women, including thyroid.",
    "biomarker_ids": [42, 43, 44, 51],
    "biomarker_groups": [
      { "biomarker_ids": [42], "required": true, "inclusion_condition": null },
      { "biomarker_ids": [43, 44], "required": true, "inclusion_condition": null },
      { "biomarker_ids": [51], "required": true, "inclusion_condition": "sex=2" }
    ],
    "pricing": { "price_cents": 11900, "retail_cents": 14900 }
  },
  {
    "id": "9c1d2e3f-4a5b-4c7d-8e9f-0a1b2c3d4e5f",
    "name": "Custom",
    "description": null,
    "biomarker_ids": [],
    "biomarker_groups": [],
    "pricing": { "price_cents": null, "retail_cents": null }
  }
]
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.