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

> Parcourir le catalogue de biomarqueurs

Renvoie un catalogue paginé des biomarqueurs que ta clé API peut commander à une origine donnée. Associe-les à des [rendez-vous](https://docs.anivahealth.com/fr/api/appointments/add-individual-biomarkers.md) ou à des [kits à domicile](https://docs.anivahealth.com/fr/api/home-kit-orders/add-individual-biomarkers.md). Les biomarqueurs archivés sont exclus.

Un biomarqueur apparaît dans la liste lorsqu'une commande auprès d'un laboratoire accessible à ta clé le fournit et que son prélèvement utilise uniquement des contenants disponibles à cette origine. Ce sont les tubes de prélèvement qui décident, pas le type d'analyte.

Nécessite le scope `panels_access`. L'objet `pricing` nécessite aussi le scope `prices_view`.

## Requête

### Paramètres de requête

L'origine prend l'une de ces deux formes : un lieu de prélèvement ou un kit à domicile. Envoie-en exactement une. Aucune ou les deux renvoient `400`.

> [tab] Lieu de prélèvement
>
> **location\_id** `string` *required*
>
> Le lieu où les prises de sang des rendez-vous sont effectuées. Un biomarqueur apparaît dans la
> liste lorsque sa commande se prélève uniquement dans des contenants disponibles dans ce lieu.
> À recouper avec [Lister les lieux](https://docs.anivahealth.com/fr/api/locations/list-locations.md).

> [tab] Kit à domicile
>
> **home\_kit** `boolean` *required*
>
> Définis sur `true`. Un biomarqueur apparaît dans la liste lorsqu'une commande auprès d'un
> laboratoire de kits à domicile se prélève uniquement dans les contenants présents dans un
> kit : sérum capillaire et EDTA, goutte de sang séché, urine et écouvillon. Les biomarqueurs
> uniquement veineux sont exclus.

**rate\_card** `string`

Remplace la grille tarifaire utilisée par `price_cents` : `retail`, ou l'`id` d'une grille tarifaire accessible à ta clé. [Obtenir une grille tarifaire](https://docs.anivahealth.com/fr/api/pricing/get-rate-card.md) renvoie cet `id`. Par défaut, la grille du compte de facturation de ta clé API, sinon le tarif public.
`retail_cents` correspond toujours à la grille publique.

**limit** `number`

Nombre maximal de résultats à renvoyer (1–1 000). Omets ce paramètre pour renvoyer tout le
catalogue correspondant — sa taille est limitée (quelques milliers de lignes tout au plus).
Lorsqu'il est omis, `pagination.limit` reprend la valeur de `total`.

**offset** `number` (default: 0)

Décalage de pagination. Doit être ≥ 0.

## Réponse

**data** `Biomarker[]`

Tableau des biomarqueurs correspondant à la requête.

**Champs du biomarqueur**

**id** `number`

Identifiant stable du biomarqueur — transmets-le à [Ajouter des biomarqueurs
personnalisés](https://docs.anivahealth.com/fr/api/appointments/add-individual-biomarkers.md).

**slug** `string`

Identifiant compatible URL.

**name** `string`

Nom d'affichage.

**description** `string | null`

Description détaillée, lorsqu'elle est disponible.

**primary\_category** `string | null`

Catégorie principale (par ex. `Hormones`, `Vitamins`).

**secondary\_category** `string | null`

Catégorie secondaire.

**type** `"clinical" | "genetic"`

Indique si ce biomarqueur est une mesure clinique ou un marqueur génétique.

**material** `string | null`

Type d'échantillon requis (par ex. `serum`, `whole_blood`).

**unit** `object | null`

Unité de mesure par défaut. Utilise `id` pour faire le lien avec [Lister les unités](https://docs.anivahealth.com/fr/api/units/list-units.md)
si tu as besoin d'un identifiant stable malgré les renommages.

**Champs de l'unité**

**id** `number`

Identifiant stable de l'unité de mesure.

**title** `string`

Nom canonique de l'unité (par ex. `nmol/L`).

**display\_title** `string | null`

Nom d'affichage lisible.

**pricing** `object | null`

Ce que coûte ce biomarqueur et comment il est vendu — voir les [objets de prix](#objets-de-prix). `null`
**uniquement** lorsque ta clé n'a pas le scope `prices_view` ; un biomarqueur sans prix défini
par Aniva est quand même renvoyé, avec `pricing.price_cents: null`.

**pagination** `object`

**Champs de pagination**

**total** `number`

Nombre total de lignes correspondant à la requête sur l'ensemble des pages.

**limit** `number`

Limite appliquée à cette page. Reprend `total` lorsque le paramètre de requête `limit` a été
omis (tout le catalogue a été renvoyé).

**offset** `number`

Décalage appliqué à cette page.

**has\_more** `boolean`

`true` lorsque d'autres pages sont disponibles.

## Objets de prix

La tarification a la même structure partout où elle apparaît — biomarqueurs, panels,
[aperçu](https://docs.anivahealth.com/fr/api/appointments/preview-containers.md) de rendez-vous et [devis](https://docs.anivahealth.com/fr/api/pricing/quote-cart.md). [Tarification](https://docs.anivahealth.com/fr/concepts/pricing.md) explique le modèle
sous-jacent ; voici la référence des champs.

Chaque montant est exprimé en centimes entiers.

**price\_cents** `integer | null`

Ce que cela coûte sur **ta** grille tarifaire. `0` est un vrai prix de zéro — l'élément n'est pas
vendu seul, et le bloc `requires` ou `positions` à côté indique comment il est vendu à la place.
`null` est différent : Aniva n'a pas fixé son prix, il n'est pas gratuit, il ne peut pas être
commandé et il n'ajoute rien à un total.

**retail\_cents** `integer | null`

Le même montant selon la grille de tarif public conseillé. Toujours présent ; égal à
`price_cents` lorsque ta clé utilise déjà la grille publique.

**tier** `"routine" | "specialty"`

Lequel des deux tarifs Aniva de ta grille a fixé le prix de ce marqueur. Présent uniquement
lorsqu'il a un prix propre.

**positions** `object[]`

Les offres commerciales contenant ce biomarqueur, de la moins chère à la plus chère. Avec
`price_cents: 0`, elles sont le seul moyen de le commander ; avec un `price_cents` positif, ce
sont les packs auxquels il appartient aussi. Une position est facturée **une seule fois** et est
toujours livrée complète.

**id** `string`

Identifiant stable du poste. Correspond à `via_position` sur la facture d'un rendez-vous.

**name** `string`

Nom du poste visible par le partenaire.

**price\_cents** `integer | null`

Coût de l'ensemble du poste sur ta grille tarifaire, facturé une seule fois. `retail_cents` figure à côté.

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

Tous les biomarqueurs fournis par le poste, y compris celui que tu as demandé.

**includes** `number[]`

Les autres éléments que le biomarqueur demandé — ce qui l'accompagne quand tu l'achètes.

**requires** `object[]`

Présent lorsque ce biomarqueur est un **ratio**. Le commander ajoute ces composants au panier à
leur propre prix, et un composant n'est payé qu'une fois par panier quel que soit le nombre de ratios qui en dépendent. Le
`price_cents` propre au ratio est facturé en plus de ses composants. La plupart des ratios coûtent `0`. Chaque
entrée contient `id`, `name`, `price_cents` et `retail_cents`.

Un ratio dont tous les composants n'ont pas de prix est totalement absent du catalogue — il
n'apparaît jamais avec `price_cents: null`.

Les panels comportent uniquement `price_cents` et `retail_cents` : un panel a un seul prix catalogue
et aucun poste ni composant.

## Réponses d'erreur

| Statut | Description |
| - | - |
| `400` | Erreur de validation — par ex. aucune origine ou deux origines, `limit` hors plage, ou `rate_card` inconnu ou non autorisé. |
| `403` | Accès refusé — scope `panels_access` manquant. |
| `404` | `location_id` ne correspond à aucun lieu de test. |
| `500` | Erreur interne du serveur. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/biomarkers?home_kit=true&limit=5' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "data": [
    {
      "id": 42,
      "slug": "vitamin-d-25-oh",
      "name": "Vitamin D (25-OH)",
      "description": "Serum 25-hydroxyvitamin D …",
      "primary_category": "Vitamins",
      "secondary_category": null,
      "type": "clinical",
      "material": "serum",
      "unit": { "id": 1, "title": "nmol/L", "display_title": null },
      "pricing": {
        "price_cents": 3952,
        "retail_cents": 4549,
        "tier": "specialty",
        "positions": [
          {
            "id": "b7d4c2e1-9a3f-4c8b-91d2-5e6f7a8b9c0d",
            "name": "Vitamin panel",
            "price_cents": 6900,
            "retail_cents": 7935,
            "biomarker_ids": [42, 43, 44],
            "includes": [43, 44]
          }
        ]
      }
    }
  ],
  "pagination": { "total": 17, "limit": 5, "offset": 0, "has_more": true }
}
```


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