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

# Lista biomarkörer

> Bläddra i biomarkörkatalogen

Returnerar en paginerad katalog över de biomarkörer din API-nyckel kan beställa för ett ursprung. Lägg till dem på [bokningar](https://docs.anivahealth.com/sv/api/appointments/add-individual-biomarkers.md) eller i [hemtestkit](https://docs.anivahealth.com/sv/api/home-kit-orders/add-individual-biomarkers.md). Arkiverade biomarkörer exkluderas.

En biomarkör visas i listan när en beställning hos ett labb din nyckel får använda levererar den, och beställningen enbart tas i provkärl som finns för ursprunget. Det är provrören som avgör, inte typen av analyt.

Kräver scopet `panels_access`. Objektet `pricing` kräver även scopet `prices_view`.

## Förfrågan

### Frågeparametrar

Ursprunget har en av två former: en testplats eller ett hemtestkit. Skicka exakt ett av dem. Inget av dem eller båda returnerar `400`.

> [tab] Testplats
>
> **location\_id** `string` *required*
>
> Platsen där blodprovstagningen för bokningarna sker. En biomarkör visas i listan när dess
> beställning enbart tas i provkärl som finns på platsen. Stäm av mot [Lista
> platser](https://docs.anivahealth.com/sv/api/locations/list-locations.md).

> [tab] Hemtestkit
>
> **home\_kit** `boolean` *required*
>
> Sätt till `true`. En biomarkör visas i listan när en beställning hos ett labb för hemtestkit
> enbart tas i de provkärl som ett kit innehåller: kapillärt serum och EDTA, torkad blodfläck,
> urin och svabbprov. Biomarkörer som enbart tas venöst utelämnas.

**rate\_card** `string`

Åsidosätt vilken prislista `price_cents` använder: `retail`, eller `id` för en prislista som din nyckel får använda. [Hämta prislista](https://docs.anivahealth.com/sv/api/pricing/get-rate-card.md) returnerar detta `id`. Standard är prislistan på din API-nyckels faktureringskonto, annars slutkundsprislistan.
`retail_cents` är alltid slutkundsprislistan.

**limit** `number`

Max antal resultat att returnera (1–1 000). Utelämna för att returnera hela den matchande
katalogen — den är begränsad (högst några tusen rader). När parametern utelämnas returnerar
`pagination.limit` samma värde som `total`.

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

Förskjutning vid paginering. Måste vara ≥ 0.

## Svar

**data** `Biomarker[]`

Array med biomarkörer som matchar frågan.

**Biomarkörfält**

**id** `number`

Stabil identifierare för biomarkören — skicka denna till [Lägg till egna
biomarkörer](https://docs.anivahealth.com/sv/api/appointments/add-individual-biomarkers.md).

**slug** `string`

URL-säker identifierare.

**name** `string`

Visningsnamn.

**description** `string | null`

Utförlig beskrivning, när den finns tillgänglig.

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

Primär kategori (t.ex. `Hormones`, `Vitamins`).

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

Sekundär kategori.

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

Om biomarkören är en klinisk mätning eller en genetisk markör.

**material** `string | null`

Provmaterial som krävs (t.ex. `serum`, `whole_blood`).

**unit** `object | null`

Standardmåttenhet. Använd `id` för att slå upp mot [Lista enheter](https://docs.anivahealth.com/sv/api/units/list-units.md) om
du behöver en stabil identifiering även om namnet ändras.

**Enhetsfält**

**id** `number`

Stabil identifierare för måttenheten.

**title** `string`

Kanoniskt enhetsnamn (t.ex. `nmol/L`).

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

Läsarvänligt visningsnamn.

**pricing** `object | null`

Vad biomarkören kostar och hur den säljs — se [prisobjekt](#prisobjekt). `null` **endast**
när din nyckel saknar scopet `prices_view`; en biomarkör som Aniva inte har prissatt
returneras ändå, med `pricing.price_cents: null`.

**pagination** `object`

**Pagineringsfält**

**total** `number`

Totalt antal rader som matchar frågan över alla sidor.

**limit** `number`

Gräns som tillämpats för den här sidan. Visar samma värde som `total` när frågeparametern
`limit` utelämnades (hela katalogen returnerades).

**offset** `number`

Förskjutning som tillämpats för den här sidan.

**has\_more** `boolean`

`true` när det finns fler sidor tillgängliga.

## Prisobjekt

Prissättningen har samma format överallt där den visas — biomarkörer, paneler, bokningens
[förhandsgranskning](https://docs.anivahealth.com/sv/api/appointments/preview-containers.md) och en [offert](https://docs.anivahealth.com/sv/api/pricing/quote-cart.md). [Prissättning](https://docs.anivahealth.com/sv/concepts/pricing.md) förklarar modellen
bakom den; det här är fältreferensen.

Varje belopp anges som heltal i cent.

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

Vad detta kostar enligt **din** prislista. `0` är ett faktiskt pris på noll — artikeln säljs inte
separat, och blocket `requires` eller `positions` intill visar hur den säljs i stället. `null` är
något annat: Aniva har inte prissatt den, den är inte kostnadsfri, den kan inte beställas och den
lägger inte till något på någon totalsumma.

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

Samma belopp enligt den rekommenderade slutkundsprislistan. Finns alltid med; lika med
`price_cents` när din nyckel redan använder slutkundsprislistan.

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

Vilken av din prislistas två Aniva-tariffer som har prissatt denna markör. Finns bara med när den
har ett eget pris.

**positions** `object[]`

De kommersiella erbjudanden som innehåller biomarkören, billigast först. Vid `price_cents: 0` är
dessa det enda sättet att beställa den; vid ett positivt `price_cents` är de paket som den också
tillhör. En position faktureras **en gång** och levereras alltid i sin helhet.

**id** `string`

Stabil positionsidentifierare. Kopplas till `via_position` på en bokningsfaktura.

**name** `string`

Positionsnamn som visas för partner.

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

Vad hela positionen kostar i din prislista, debiteras en gång. `retail_cents` ligger bredvid.

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

Alla biomarkörer som positionen levererar, inklusive den du frågade efter.

**includes** `number[]`

Övriga delar utöver den biomarkör du frågade efter – det som följer med när du köper den.

**requires** `object[]`

Finns med när denna biomarkör är en **kvot**. När du beställer den läggs dessa komponenter i
varukorgen till sina egna priser, och en komponent betalas bara en gång per varukorg oavsett hur
många kvoter som bygger på den. Kvotens eget `price_cents` debiteras utöver dess komponenter. De
flesta kvoter kostar `0`. Varje post innehåller `id`, `name`, `price_cents` och `retail_cents`.

En kvot vars komponenter inte alla är prissatta saknas helt i katalogen – den visas aldrig
med `price_cents: null`.

Paneler har enbart `price_cents` och `retail_cents`: en panel har ett enda katalogpris och inga
positioner eller komponenter.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel – t.ex. inget ursprung eller två ursprung, `limit` utanför tillåtet intervall eller okänt/obehörigt `rate_card`. |
| `403` | Åtkomst nekad – saknar scopet `panels_access`. |
| `404` | `location_id` matchar ingen testplats. |
| `500` | Internt serverfel. |

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