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

# Ottieni biomarcatore

> Recupera un singolo biomarcatore tramite ID

Restituisce un singolo biomarcatore tramite il suo `id` numerico. Utile per risolvere gli ID restituiti da [Elenca pannelli](https://docs.anivahealth.com/it/api/panels/list-panels.md) o dai payload degli appuntamenti in dettagli completi (nome, unità, materiale, categoria) senza scorrere l'intero catalogo.

Serve lo stesso catalogo di [Elenca biomarcatori](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md), quindi invia la stessa origine. Un biomarcatore archiviato restituisce `404`. Lo stesso vale per un biomarcatore che non puoi ordinare da quell'origine con i laboratori che la tua chiave può usare.

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

## Parametri di percorso

**id** `number` *required*

Identificatore del biomarcatore.

## 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 viene effettuato il prelievo dell'appuntamento. Il biomarcatore restituisce
> `404` a meno che il suo ordine non richieda il prelievo solo nei contenitori disponibili in
> quella sede.

> [tab] Kit domiciliare
>
> **home\_kit** `boolean` *required*
>
> Imposta su `true`. Il biomarcatore restituisce `404` a meno che un ordine presso un
> laboratorio per kit domiciliari non richieda il prelievo solo nei contenitori presenti nel
> kit.

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

## Risposta

**id** `number`

Identificatore stabile del biomarcatore.

**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](https://docs.anivahealth.com/it/api/biomarkers/list-biomarkers.md#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`.

## Risposte di errore

| Stato | Descrizione |
| - | - |
| `400` | Errore di convalida — `id` non valido, nessuna origine o due origini, oppure `rate_card` sconosciuto o non autorizzato. |
| `403` | Vietato — scope `panels_access` mancante. |
| `404` | Biomarcatore non trovato, archiviato o non ordinabile dall'origine. Anche per un `location_id` sconosciuto. |
| `500` | Errore interno del server. |

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

```json 200 theme={null}
{
  "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"
  }
}
```

```json 200 (sold only inside a position) theme={null}
{
  "id": 77,
  "slug": "mean-platelet-volume",
  "name": "Mean Platelet Volume (MPV)",
  "description": null,
  "primary_category": "Haematology",
  "secondary_category": null,
  "type": "clinical",
  "material": "whole_blood",
  "unit": { "id": 7, "title": "fL", "display_title": null },
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```


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