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

# List opp biomarkører

> Bla gjennom biomarkørkatalogen

Returnerer en paginert katalog over biomarkørene API-nøkkelen din kan bestille for én opprinnelse. Legg dem til i [timer](https://docs.anivahealth.com/no/api/appointments/add-individual-biomarkers.md) eller i [hjemmetestsett](https://docs.anivahealth.com/no/api/home-kit-orders/add-individual-biomarkers.md). Arkiverte biomarkører er ekskludert.

En biomarkør listes opp når en bestilling ved et laboratorium nøkkelen din kan bruke leverer den, og bestillingen kun tas i beholdere som opprinnelsen har. Prøverørene avgjør, ikke analyttypen.

Krever scopet `panels_access`. Objektet `pricing` krever også scopet `prices_view`.

## Forespørsel

### Spørreparametere

Opprinnelsen har én av to former: et teststed eller et hjemmetestsett. Send nøyaktig én. Ingen eller begge returnerer `400`.

> [tab] Teststed
>
> **location\_id** `string` *required*
>
> Teststedet der blodprøvetakingen for timene skjer. En biomarkør listes opp når bestillingen
> kun tas i beholdere som det stedet har. Sammenstill med [Vis teststeder](https://docs.anivahealth.com/no/api/locations/list-locations.md).

> [tab] Hjemmetestsett
>
> **home\_kit** `boolean` *required*
>
> Sett til `true`. En biomarkør listes opp når en bestilling hos et laboratorium for
> hjemmetestsett kun tas i beholdere som settet inneholder: kapillært serum og EDTA, tørket
> bloddråpe, urin og penselprøve. Biomarkører som kun tas venøst, utelates.

**rate\_card** `string`

Overstyr hvilken prisliste `price_cents` bruker: `retail`, eller `id` for en prisliste nøkkelen din kan bruke. [Hent prisliste](https://docs.anivahealth.com/no/api/pricing/get-rate-card.md) returnerer denne `id`-en. Standard er prislisten på faktureringskontoen til API-nøkkelen din, ellers veiledende prisliste.
`retail_cents` er alltid den veiledende prislisten.

**limit** `number`

Maksimalt antall resultater som returneres (1–1 000). Utelat for å returnere hele den matchende
katalogen – den er begrenset (høyst noen få tusen rader). Når den utelates, gjentar
`pagination.limit` verdien i `total`.

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

Pagineringsforskyvning. Må være ≥ 0.

## Respons

**data** `Biomarker[]`

Liste med biomarkører som matcher spørringen.

**Biomarkørfelt**

**id** `number`

Stabil biomarkøridentifikator – send denne til [Legg til egendefinerte
biomarkører](https://docs.anivahealth.com/no/api/appointments/add-individual-biomarkers.md).

**slug** `string`

URL-sikker identifikator.

**name** `string`

Visningsnavn.

**description** `string | null`

Utførlig beskrivelse, når den er tilgjengelig.

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

Primærkategori (f.eks. `Hormones`, `Vitamins`).

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

Sekundærkategori.

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

Om denne biomarkøren er en klinisk måling eller en genetisk markør.

**material** `string | null`

Påkrevd prøvemateriale (f.eks. `serum`, `whole_blood`).

**unit** `object | null`

Standard måleenhet. Bruk `id` for å slå opp mot [Vis enheter](https://docs.anivahealth.com/no/api/units/list-units.md) hvis du
trenger stabil identitet på tvers av navneendringer.

**Enhetsfelt**

**id** `number`

Stabil identifikator for måleenheten.

**title** `string`

Kanonisk enhetstittel (f.eks. `nmol/L`).

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

Brukervennlig visningstittel.

**pricing** `object | null`

Hva denne biomarkøren koster og hvordan den selges – se [prisobjekter](#prisobjekter).
`null` **kun** når nøkkelen din mangler scopet `prices_view`; en biomarkør Aniva ikke har
priset returneres likevel, med `pricing.price_cents: null`.

**pagination** `object`

**Pagineringsfelt**

**total** `number`

Totalt antall rader som matcher spørringen på tvers av alle sider.

**limit** `number`

Grensen som gjelder for denne siden. Gjentar `total` når spørreparameteren `limit` ble
utelatt (hele katalogen ble returnert).

**offset** `number`

Forskyvningen som gjelder for denne siden.

**has\_more** `boolean`

`true` når flere sider er tilgjengelige.

## Prisobjekter

Prising har én og samme form overalt der den vises – biomarkører, paneler,
[forhåndsvisningen](https://docs.anivahealth.com/no/api/appointments/preview-containers.md) av timen og et [pristilbud](https://docs.anivahealth.com/no/api/pricing/quote-cart.md). [Prising](https://docs.anivahealth.com/no/concepts/pricing.md) forklarer modellen
bak; dette er feltreferansen.

Hvert beløp er et heltall i cent.

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

Hva dette koster på **din** prisliste. `0` er en reell pris på null – varen selges ikke separat,
og blokken `requires` eller `positions` ved siden av viser hvordan den selges i stedet. `null`
er noe annet: Aniva har ikke priset den, den er ikke kostnadsfri, den kan ikke bestilles, og den
legger ingenting til noen totalsum.

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

Det samme beløpet på den veiledende prislisten. Alltid til stede; lik `price_cents` når nøkkelen
din allerede bruker den veiledende prislisten.

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

Hvilken av de to Aniva-satsene på prislisten din som priset denne markøren. Kun til stede når
den har en egen pris.

**positions** `object[]`

De kommersielle tilbudene som inneholder denne biomarkøren, billigst først. Med
`price_cents: 0` er disse den eneste måten å bestille den på; med en positiv `price_cents` er de
pakkene den også inngår i. En posisjon faktureres **én gang** og leveres alltid i sin helhet.

**id** `string`

Stabil posisjonsidentifikator. Kobles mot `via_position` på fakturaen for en time.

**name** `string`

Posisjonsnavn som vises til partnere.

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

Hva hele posisjonen koster i prislisten din, fakturert én gang. `retail_cents` står ved siden av.

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

Alle biomarkører posisjonen leverer, inkludert den du spurte om.

**includes** `number[]`

De andre biomarkørene enn den du spurte om – det som følger med når du kjøper den.

**requires** `object[]`

Finnes når denne biomarkøren er et **forholdstall**. Når du bestiller det, legges disse komponentene i handlekurven til
sine egne priser, og en komponent betales én gang per handlekurv uansett hvor mange forholdstall som bygger på den.
Forholdstallets egen `price_cents` faktureres i tillegg til komponentene. De fleste forholdstall koster `0`. Hver
oppføring inneholder `id`, `name`, `price_cents` og `retail_cents`.

Et forholdstall der ikke alle komponentene er priset, mangler helt i katalogen – det vises aldri
med `price_cents: null`.

Paneler har bare `price_cents` og `retail_cents`: et panel har én enkelt katalogpris og ingen
posisjoner eller komponenter.

## Feilresponser

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfeil – f.eks. ingen opprinnelse eller to opprinnelser, `limit` utenfor gyldig område, eller ukjent/uautorisert `rate_card`. |
| `403` | Forbudt – mangler `panels_access`-scope. |
| `404` | `location_id` samsvarer ikke med noe teststed. |
| `500` | Intern serverfeil. |

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