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

# Llista els biomarcadors

> Explora el catàleg de biomarcadors

Retorna un catàleg paginat dels biomarcadors que la teva clau d'API pot demanar en un origen. Afegeix-los a [cites](https://docs.anivahealth.com/ca/api/appointments/add-individual-biomarkers.md) o a [kits de prova a casa](https://docs.anivahealth.com/ca/api/home-kit-orders/add-individual-biomarkers.md). Els biomarcadors arxivats queden exclosos.

Un biomarcador apareix a la llista quan una comanda en un laboratori que la teva clau pot fer servir el proporciona i la comanda fa la recollida només en els envasos que té l'origen. Decideixen els tubs de mostra, no el tipus d'analit.

Requereix l'àmbit `panels_access`. L'objecte `pricing` també requereix l'àmbit `prices_view`.

## Sol·licitud

### Paràmetres de consulta

L'origen té una de dues formes: un centre de proves o un kit de prova a casa. Envia'n exactament un. Cap dels dos o tots dos retorna `400`.

> [tab] Centre de proves
>
> **location\_id** `string` *required*
>
> El centre on es fan les extraccions de sang de les cites. Un biomarcador apareix a la llista quan la seva comanda fa la recollida només en
> envasos que té aquest centre. Relaciona-ho amb [Llistar centres](https://docs.anivahealth.com/ca/api/locations/list-locations.md).

> [tab] Kit de prova a casa
>
> **home\_kit** `boolean` *required*
>
> Defineix-lo com a `true`. Un biomarcador apareix a la llista quan una comanda en un laboratori de kits de prova a casa fa la recollida només en els
> envasos que conté un kit: sèrum capil·lar i EDTA, gota de sang seca, orina i hisop.
> Els biomarcadors que només admeten sang venosa queden fora.

**rate\_card** `string`

Substitueix la taula de tarifes que utilitza `price_cents`: `retail`, o l'`id` d'una taula de tarifes que la teva clau pugui fer servir. [Obtenir taula de tarifes](https://docs.anivahealth.com/ca/api/pricing/get-rate-card.md) retorna aquest `id`. Per defecte fa servir la taula del compte de facturació de la teva clau d'API; si no, la de venda al públic.
`retail_cents` correspon sempre a la taula de venda al públic.

**limit** `number`

Màxim de resultats que es retornen (1–1.000). Omet-lo per retornar tot el catàleg coincident — és acotat (uns
quants milers de files com a màxim). Si s'omet, `pagination.limit` repeteix `total`.

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

Desplaçament de paginació. Ha de ser ≥ 0.

## Resposta

**data** `Biomarker[]`

Matriu de biomarcadors que coincideixen amb la consulta.

**Camps del biomarcador**

**id** `number`

Identificador estable del biomarcador — passa'l a [Afegir biomarcadors
personalitzats](https://docs.anivahealth.com/ca/api/appointments/add-individual-biomarkers.md).

**slug** `string`

Identificador apte per a URL.

**name** `string`

Nom visible.

**description** `string | null`

Descripció detallada, quan estigui disponible.

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

Categoria principal (p. ex., `Hormones`, `Vitamins`).

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

Categoria secundària.

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

Indica si aquest biomarcador és una mesura clínica o un marcador genètic.

**material** `string | null`

Material de mostra requerit (p. ex., `serum`, `whole_blood`).

**unit** `object | null`

Unitat de mesura per defecte. Fes servir `id` per resoldre-la amb [Llistar unitats](https://docs.anivahealth.com/ca/api/units/list-units.md)
si necessites una identitat estable tot i els canvis de nom.

**Camps de la unitat**

**id** `number`

Identificador estable de la unitat de mesura.

**title** `string`

Títol canònic de la unitat (p. ex., `nmol/L`).

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

Títol visible llegible.

**pricing** `object | null`

El que costa aquest biomarcador i com es ven — consulta els [objectes de preu](#objectes-de-preu). És `null`
**només** quan la teva clau no té l'àmbit `prices_view`; un biomarcador al qual Aniva no ha posat preu es
retorna igualment, amb `pricing.price_cents: null`.

**pagination** `object`

**Camps de paginació**

**total** `number`

Total de files que coincideixen amb la consulta en totes les pàgines.

**limit** `number`

Límit aplicat a aquesta pàgina. Repeteix `total` quan s'ha omès el paràmetre de consulta `limit` (s'ha
retornat tot el catàleg).

**offset** `number`

Desplaçament aplicat a aquesta pàgina.

**has\_more** `boolean`

`true` quan hi ha més pàgines disponibles.

## Objectes de preu

Els preus tenen una única estructura arreu on apareixen — biomarcadors, panells, la
[previsualització](https://docs.anivahealth.com/ca/api/appointments/preview-containers.md) de la cita i un [pressupost](https://docs.anivahealth.com/ca/api/pricing/quote-cart.md). [Preus](https://docs.anivahealth.com/ca/concepts/pricing.md) explica el model
que hi ha al darrere; aquesta és la referència dels camps.

Cada import s'expressa en cèntims sencers.

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

El que costa a la **teva** taula de tarifes. `0` és un preu real de zero — l'article no es ven per
separat, i el bloc `requires` o `positions` del costat indica com es ven. `null` és
diferent: Aniva no hi ha posat preu, no és de franc, no es pot demanar i no suma res a
cap total.

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

El mateix import a la taula de venda al públic recomanada. Sempre present; igual a `price_cents` quan la teva
clau ja fa servir la taula de venda al públic.

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

Quina de les dues tarifes d'Aniva de la teva taula ha fixat el preu d'aquest marcador. Present només quan té un preu
propi.

**positions** `object[]`

Les ofertes comercials que contenen aquest biomarcador, primer les més barates. Amb `price_cents: 0` són
l'única manera de demanar-lo; amb un `price_cents` positiu són els paquets als quals també pertany.
Una posició es factura **una vegada** i sempre es lliura sencera.

**id** `string`

Identificador estable de la posició. Enllaça amb `via_position` a la factura d'una cita.

**name** `string`

Nom de la posició visible per als socis.

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

El que costa tota la posició a la teva tarifa, facturat un sol cop. `retail_cents` apareix al costat.

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

Tots els biomarcadors que inclou la posició, inclòs el que has consultat.

**includes** `number[]`

Els altres elements a banda del biomarcador que has consultat — el que s'afegeix quan el compres.

**requires** `object[]`

Present quan aquest biomarcador és una **ràtio**. Si la demanes, aquests components s'afegeixen a la cistella amb
el seu propi preu, i cada component es paga un sol cop per cistella, independentment de quantes ràtios en depenguin. El
`price_cents` propi de la ràtio es factura a banda dels seus components. La majoria de les ràtios costen `0`. Cada
entrada inclou `id`, `name`, `price_cents` i `retail_cents`.

Una ràtio que no té preu per a tots els components queda fora del catàleg — mai
no apareix amb `price_cents: null`.

Els panells només porten `price_cents` i `retail_cents`: un panell té un únic preu de catàleg i cap
posició ni component.

## Respostes d'error

| Estat | Descripció |
| - | - |
| `400` | Error de validació — p. ex., cap origen o dos orígens, `limit` fora de rang o `rate_card` desconeguda o no autoritzada. |
| `403` | Prohibit — falta l'àmbit `panels_access`. |
| `404` | `location_id` no correspon a cap ubicació de proves. |
| `500` | Error intern del servidor. |

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