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

# Elenca biomarcatori

> Sfoglia il catalogo dei biomarcatori

Restituisce un catalogo impaginato dei biomarcatori che la tua chiave API può ordinare da una singola origine. Associali agli [appuntamenti](https://docs.anivahealth.com/it/api/appointments/add-individual-biomarkers.md) o ai [kit domiciliari](https://docs.anivahealth.com/it/api/home-kit-orders/add-individual-biomarkers.md). I biomarcatori archiviati sono esclusi.

Un biomarcatore viene elencato quando un ordine presso un laboratorio che la tua chiave può usare lo include e richiede il prelievo solo nei contenitori disponibili presso l'origine. A decidere sono le provette, non il tipo di analita.

Richiede lo scope `panels_access`. L'oggetto `pricing` richiede anche lo scope `prices_view`.

## Richiesta

### Parametri di query

L'origine può avere due forme: una sede per esami o un kit domiciliare. Inviane esattamente una. Nessuna o entrambe restituiscono `400`.

> [tab] Sede per esami
>
> **location\_id** `string` *required*
>
> La sede in cui vengono effettuati i prelievi degli appuntamenti. Un biomarcatore viene
> elencato quando il suo ordine richiede il prelievo solo nei contenitori disponibili in quella
> sede. Correla con [Elenca sedi](https://docs.anivahealth.com/it/api/locations/list-locations.md).

> [tab] Kit domiciliare
>
> **home\_kit** `boolean` *required*
>
> Imposta su `true`. Un biomarcatore viene elencato quando un ordine presso un laboratorio per
> kit domiciliari richiede il prelievo solo nei contenitori presenti nel kit: siero capillare ed
> EDTA, goccia di sangue essiccato, urine e tampone. I biomarcatori che richiedono solo sangue
> venoso vengono esclusi.

**rate\_card** `string`

Sostituisci il listino prezzi usato da `price_cents`: `retail`, oppure l'`id` di un listino che la tua chiave può usare. [Ottieni listino prezzi](https://docs.anivahealth.com/it/api/pricing/get-rate-card.md) restituisce quell'`id`. Per impostazione predefinita usa il listino dell'account di fatturazione della tua chiave API, altrimenti il listino retail.
`retail_cents` usa sempre il listino retail.

**limit** `number`

Numero massimo di risultati da restituire (1–1.000). Ometti per restituire l'intero catalogo
corrispondente — è limitato (al massimo qualche migliaio di righe). Quando omesso,
`pagination.limit` restituisce `total`.

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

Offset di impaginazione. Deve essere ≥ 0.

## Risposta

**data** `Biomarker[]`

Array di biomarcatori che corrispondono alla query.

**Campi del biomarcatore**

**id** `number`

Identificatore stabile del biomarcatore — passalo a [Aggiungi biomarcatori
personalizzati](https://docs.anivahealth.com/it/api/appointments/add-individual-biomarkers.md).

**slug** `string`

Identificatore compatibile con gli URL.

**name** `string`

Nome visualizzato.

**description** `string | null`

Descrizione estesa, quando disponibile.

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

Categoria principale (ad es. `Hormones`, `Vitamins`).

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

Categoria secondaria.

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

Indica se questo biomarcatore è una misurazione clinica o un marcatore genetico.

**material** `string | null`

Materiale del campione richiesto (ad es. `serum`, `whole_blood`).

**unit** `object | null`

Unità di misura predefinita. Usa `id` per dereferenziare rispetto a [Elenca unità](https://docs.anivahealth.com/it/api/units/list-units.md)
se hai bisogno di un'identità stabile anche dopo eventuali rinomine.

**Campi dell'unità**

**id** `number`

Identificatore stabile dell'unità di misura.

**title** `string`

Titolo canonico dell'unità (ad es. `nmol/L`).

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

Titolo visualizzato leggibile.

**pricing** `object | null`

Quanto costa questo biomarcatore e come viene venduto — vedi [oggetti prezzo](#oggetti-prezzo). È `null`
**solo** quando alla tua chiave manca lo scope `prices_view`; un biomarcatore a cui Aniva non ha assegnato un prezzo viene
comunque restituito, con `pricing.price_cents: null`.

**pagination** `object`

**Campi di impaginazione**

**total** `number`

Totale delle righe corrispondenti alla query su tutte le pagine.

**limit** `number`

Limite applicato a questa pagina. Restituisce `total` quando il parametro di query `limit` è
stato omesso (è stato restituito l'intero catalogo).

**offset** `number`

Offset applicato a questa pagina.

**has\_more** `boolean`

`true` quando sono disponibili altre pagine.

## Oggetti prezzo

La struttura dei prezzi è la stessa ovunque compaia — biomarcatori, pannelli,
[anteprima](https://docs.anivahealth.com/it/api/appointments/preview-containers.md) dell'appuntamento e [preventivo](https://docs.anivahealth.com/it/api/pricing/quote-cart.md). [Prezzi](https://docs.anivahealth.com/it/concepts/pricing.md) spiega il modello
alla base; questo è il riferimento dei campi.

Ogni importo è espresso in centesimi interi.

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

Quanto costa sul **tuo** listino prezzi. `0` è un vero prezzo pari a zero — l'articolo non è venduto
singolarmente e il blocco `requires` o `positions` accanto indica invece come viene venduto. `null` è
diverso: Aniva non gli ha assegnato un prezzo, non è a costo zero, non può essere ordinato e non aggiunge nulla a
nessun totale.

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

Lo stesso importo secondo il listino retail consigliato. Sempre presente; uguale a `price_cents` quando la tua
chiave usa già il listino retail.

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

Quale delle due tariffe Aniva del tuo listino ha determinato il prezzo di questo marcatore. Presente solo quando ha un prezzo
proprio.

**positions** `object[]`

Le offerte commerciali che contengono questo biomarcatore, dalla più economica. Con `price_cents: 0` sono
l'unico modo per ordinarlo; con un `price_cents` positivo sono i pacchetti di cui fa inoltre parte.
Una posizione viene fatturata **una sola volta** e viene sempre fornita per intero.

**id** `string`

Identificatore stabile della posizione. Corrisponde a `via_position` nella fattura di un appuntamento.

**name** `string`

Nome della posizione visibile ai partner.

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

Quanto costa l'intera posizione nel tuo listino, addebitata una volta sola. `retail_cents` lo affianca.

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

Ogni biomarcatore fornito dalla posizione, compreso quello che hai richiesto.

**includes** `number[]`

Gli elementi diversi dal biomarcatore che hai richiesto — ciò che viene aggiunto quando lo acquisti.

**requires** `object[]`

Presente quando questo biomarcatore è un **rapporto**. Ordinarlo aggiunge questi componenti al carrello ai
rispettivi prezzi, e ogni componente viene pagato una sola volta per carrello, indipendentemente da quanti rapporti si basano su di esso. Il
`price_cents` del rapporto stesso viene addebitato in aggiunta ai suoi componenti. La maggior parte dei rapporti costa `0`. Ogni
voce contiene `id`, `name`, `price_cents` e `retail_cents`.

Un rapporto i cui componenti non hanno tutti un prezzo è del tutto assente dal catalogo — non
appare mai con `price_cents: null`.

I pannelli hanno solo `price_cents` e `retail_cents`: un pannello ha un unico prezzo di catalogo e
nessuna posizione o componente.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Errore di validazione — ad es. nessuna origine o due origini, `limit` fuori intervallo oppure `rate_card` sconosciuta o non autorizzata. |
| `403` | Accesso negato — manca lo scope `panels_access`. |
| `404` | `location_id` non corrisponde ad alcuna sede di analisi. |
| `500` | Errore interno del server. |

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