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

# Listează biomarkerii

> Răsfoiește catalogul de biomarkeri

Returnează un catalog paginat cu biomarkerii pe care cheia ta API îi poate comanda la o origine. Atașează-i la [programări](https://docs.anivahealth.com/ro/api/appointments/add-individual-biomarkers.md) sau la [kituri de testare la domiciliu](https://docs.anivahealth.com/ro/api/home-kit-orders/add-individual-biomarkers.md). Biomarkerii arhivați sunt excluși.

Un biomarker apare în listă atunci când o comandă la un laborator pe care cheia ta îl poate folosi îl furnizează, iar comanda se recoltează doar în recipientele pe care le deține originea. Tuburile de probă decid, nu tipul de analit.

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

## Cerere

### 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 fac recoltările pentru programări. Un biomarker apare în listă când comanda sa se recoltează doar în
> recipientele pe care le deține acea locație. Corelează cu [Listare locații](https://docs.anivahealth.com/ro/api/locations/list-locations.md).

> [tab] Kit de testare la domiciliu
>
> **home\_kit** `boolean` *required*
>
> Setează la `true`. Un biomarker apare în listă când o comandă la un laborator pentru kituri de testare la domiciliu se recoltează doar în
> recipientele pe care le conține un kit: ser capilar și EDTA, picătură de sânge uscat, urină și tampon.
> Biomarkerii care necesită doar sânge venos sunt excluși.

**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.
`retail_cents` reprezintă întotdeauna grila retail.

**limit** `number`

Numărul maxim de rezultate returnate (1–1.000). Omite acest parametru pentru a returna întregul catalog care corespunde — este limitat (cel
mult câteva mii de rânduri). Când este omis, `pagination.limit` preia valoarea `total`.

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

Decalaj de paginare. Trebuie să fie ≥ 0.

## Răspuns

**data** `Biomarker[]`

Listă de biomarkeri care corespund interogării.

**Câmpurile biomarkerului**

**id** `number`

Identificator stabil al biomarkerului — transmite-l la [Adăugare biomarkeri
personalizați](https://docs.anivahealth.com/ro/api/appointments/add-individual-biomarkers.md).

**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ț](#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`.

**pagination** `object`

**Câmpurile paginării**

**total** `number`

Numărul total de rânduri care corespund interogării pe toate paginile.

**limit** `number`

Limita aplicată acestei pagini. Preia valoarea `total` când parametrul de interogare `limit` a fost omis (a fost returnat
întregul catalog).

**offset** `number`

Decalajul aplicat acestei pagini.

**has\_more** `boolean`

`true` când sunt disponibile mai multe pagini.

## Obiecte de preț

Prețurile au aceeași structură oriunde apar — biomarkeri, paneluri,
[previzualizarea](https://docs.anivahealth.com/ro/api/appointments/preview-containers.md) programării și o [estimare de preț](https://docs.anivahealth.com/ro/api/pricing/quote-cart.md). [Prețuri](https://docs.anivahealth.com/ro/concepts/pricing.md) explică modelul
din spatele acestora; aceasta este referința câmpurilor.

Fiecare sumă este exprimată în cenți, ca număr întreg.

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

Cât costă pe grila **ta** de tarife. `0` este un preț real de zero — articolul nu se vinde
separat, iar blocul `requires` sau `positions` de lângă el indică cum se vinde în schimb. `null` este
diferit: Aniva nu i-a stabilit un preț, nu este fără cost, nu poate fi comandat și nu adaugă nimic la
niciun total.

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

Aceeași sumă conform grilei retail recomandate. Întotdeauna prezent; egal cu `price_cents` când cheia
ta folosește deja grila retail.

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

Care dintre cele două tarife Aniva ale grilei tale a stabilit prețul acestui marker. Prezent doar când are un preț
propriu.

**positions** `object[]`

Ofertele comerciale care conțin acest biomarker, în ordinea crescătoare a prețului. Cu `price_cents: 0`, acestea sunt
singura modalitate de a-l comanda; cu un `price_cents` pozitiv, sunt pachetele din care face de asemenea parte.
O poziție se facturează **o singură dată** și este livrată întotdeauna integral.

**id** `string`

Identificator stabil al poziției. Se leagă de `via_position` pe factura unei programări.

**name** `string`

Numele poziției afișat partenerului.

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

Costul întregii poziții în grila ta de tarife, facturat o singură dată. `retail_cents` apare alături.

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

Fiecare biomarker pe care îl oferă poziția, inclusiv cel pe care l-ai interogat.

**includes** `number[]`

Ceilalți membri în afară de biomarkerul pe care l-ai interogat — ce vine la pachet când îl cumperi.

**requires** `object[]`

Prezent când acest biomarker este un **raport**. Comandarea lui adaugă aceste componente în coș
la prețurile lor proprii, iar o componentă se plătește o singură dată per coș, indiferent câte rapoarte se bazează pe ea.
Propriul `price_cents` al raportului se facturează pe lângă componentele sale. Majoritatea rapoartelor costă `0`. Fiecare
intrare conține `id`, `name`, `price_cents` și `retail_cents`.

Un raport ale cărui componente nu au toate preț lipsește complet din catalog — nu
apare niciodată cu `price_cents: null`.

Panelurile au doar `price_cents` și `retail_cents`: un panel are un singur preț de catalog, fără
poziții sau componente.

## Răspunsuri de eroare

| Status | Descriere |
| - | - |
| `400` | Eroare de validare — de ex. fără origine sau cu două origini, `limit` în afara intervalului sau `rate_card` necunoscut/neautorizat. |
| `403` | Interzis — lipsește scope-ul `panels_access`. |
| `404` | `location_id` nu corespunde niciunei locații de testare. |
| `500` | Eroare internă de 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.