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

# Obține biomarkerul

> Preia un singur biomarker după ID

Returnează un singur biomarker după `id`-ul său numeric. Util pentru a transforma ID-urile returnate de [Listare paneluri](https://docs.anivahealth.com/ro/api/panels/list-panels.md) sau din payload-urile programărilor în detalii complete (nume, unitate, material, categorie), fără a parcurge întregul catalog.

Servește același catalog ca [Listare biomarkeri](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md), așa că trimite aceeași origine. Un biomarker arhivat returnează `404`. La fel și un biomarker pe care nu îl poți comanda la acea origine cu laboratoarele pe care cheia ta le poate folosi.

Necesită scope-ul `panels_access`. Obiectul `pricing` necesită, de asemenea, scope-ul `prices_view`.

## Parametri de cale

**id** `number` *required*

Identificatorul biomarkerului.

## Parametri de interogare

Originea are una dintre cele două forme: o locație de testare sau un kit de testare la domiciliu. Trimite exact una. Lipsa originii sau trimiterea ambelor returnează `400`.

> [tab] Locație de testare
>
> **location\_id** `string` *required*
>
> Locația în care se face recoltarea pentru programare. Biomarkerul returnează `404` dacă comanda sa
> nu se recoltează doar în recipientele pe care le deține acea locație.

> [tab] Kit de testare la domiciliu
>
> **home\_kit** `boolean` *required*
>
> Setează la `true`. Biomarkerul returnează `404` dacă o comandă la un laborator pentru kituri de testare la domiciliu
> nu se recoltează doar în recipientele pe care le conține un kit.

**rate\_card** `string`

Suprascrie grila de tarife folosită de `price_cents`: `retail` sau `id`-ul unei grile de tarife pe care cheia ta o poate folosi. [Obținere grilă de tarife](https://docs.anivahealth.com/ro/api/pricing/get-rate-card.md) returnează acel `id`. Implicit se folosește grila din contul de facturare al cheii tale API, altfel cea retail.

## Răspuns

**id** `number`

Identificator stabil al biomarkerului.

**slug** `string`

Identificator compatibil cu URL-urile.

**name** `string`

Nume afișat.

**description** `string | null`

Descriere detaliată, când este disponibilă.

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

Categorie principală (de ex. `Hormones`, `Vitamins`).

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

Categorie secundară.

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

Indică dacă acest biomarker este o măsurătoare clinică sau un marker genetic.

**material** `string | null`

Materialul de probă necesar (de ex. `serum`, `whole_blood`).

**unit** `object | null`

Unitatea de măsură implicită. Folosește `id` pentru a face referire la [Listare unități](https://docs.anivahealth.com/ro/api/units/list-units.md) dacă
ai nevoie de o identitate stabilă în cazul redenumirilor.

**Câmpurile unității**

**id** `number`

Identificator stabil al unității de măsură.

**title** `string`

Denumirea canonică a unității (de ex. `nmol/L`).

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

Denumire afișată ușor de citit.

**pricing** `object | null`

Cât costă acest biomarker și cum se vinde — vezi [obiectele de
preț](https://docs.anivahealth.com/ro/api/biomarkers/list-biomarkers.md#obiecte-de-pret). Este `null` **doar** când cheii tale îi lipsește
scope-ul `prices_view`; un biomarker căruia Aniva nu i-a stabilit un preț este totuși returnat, cu
`pricing.price_cents: null`.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — `id` nevalid, nicio origine sau două origini, ori `rate_card` necunoscut sau neautorizat. |
| `403` | Interzis — lipsește scope-ul `panels_access`. |
| `404` | Biomarkerul nu a fost găsit, este arhivat sau nu poate fi comandat la acea origine. De asemenea, pentru un `location_id` necunoscut. |
| `500` | Eroare internă de 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.