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

# Vis biomarkører

> Gennemse biomarkørkataloget

Returnerer et pagineret katalog over de biomarkører, din API-nøgle kan bestille for én oprindelse. Tilknyt dem til [tider](https://docs.anivahealth.com/da/api/appointments/add-individual-biomarkers.md) eller [hjemmetestkits](https://docs.anivahealth.com/da/api/home-kit-orders/add-individual-biomarkers.md). Arkiverede biomarkører er udeladt.

En biomarkør vises, når en ordre hos et laboratorium, din nøgle må bruge, leverer den, og ordren kun bruger beholdere, som oprindelsen har. Det er prøverørene, der afgør det, ikke analyttypen.

Kræver `panels_access`-scope. Objektet `pricing` kræver også `prices_view`-scope.

## Forespørgsel

### Forespørgselsparametre

Oprindelsen har én af to former: en testlokation eller et hjemmetestkit. Send præcis én. Ingen eller begge returnerer `400`.

> [tab] Testlokation
>
> **location\_id** `string` *required*
>
> Lokationen, hvor blodprøvetagningen til tiderne foregår. En biomarkør vises, når dens ordre
> kun bruger beholdere, som lokationen har. Sammenhold med [Vis lokationer](https://docs.anivahealth.com/da/api/locations/list-locations.md).

> [tab] Hjemmetestkit
>
> **home\_kit** `boolean` *required*
>
> Sæt til `true`. En biomarkør vises, når en ordre hos et laboratorium til hjemmetestkits kun
> bruger de beholdere, et kit indeholder: kapillærserum og EDTA, tørret blodplet, urin og
> podning. Biomarkører, der kun kan tages venøst, udelades.

**rate\_card** `string`

Tilsidesæt, hvilken prisliste `price_cents` bruger: `retail`, eller `id` for en prisliste, din nøgle må bruge. [Hent prisliste](https://docs.anivahealth.com/da/api/pricing/get-rate-card.md) returnerer det `id`. Bruger som standard prislisten på din API-nøgles faktureringskonto, ellers detailprislisten.
`retail_cents` bruger altid detailprislisten.

**limit** `number`

Maksimalt antal resultater, der returneres (1–1.000). Udelad for at returnere hele det matchende
katalog — det er begrænset (højst nogle få tusinde rækker). Når det udelades, gengiver
`pagination.limit` værdien fra `total`.

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

Pagineringsoffset. Skal være ≥ 0.

## Svar

**data** `Biomarker[]`

Array af biomarkører, der matcher forespørgslen.

**Biomarkørfelter**

**id** `number`

Stabil identifikator for biomarkøren — send denne til [Tilføj tilpassede
biomarkører](https://docs.anivahealth.com/da/api/appointments/add-individual-biomarkers.md).

**slug** `string`

URL-sikker identifikator.

**name** `string`

Visningsnavn.

**description** `string | null`

Uddybende beskrivelse, når den findes.

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

Primær kategori (f.eks. `Hormones`, `Vitamins`).

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

Sekundær kategori.

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

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

**material** `string | null`

Påkrævet prøvemateriale (f.eks. `serum`, `whole_blood`).

**unit** `object | null`

Standardmåleenhed. Brug `id` til at slå op mod [Vis enheder](https://docs.anivahealth.com/da/api/units/list-units.md), hvis du
har brug for stabil identitet på tværs af navneændringer.

**Enhedsfelter**

**id** `number`

Stabil identifikator for måleenheden.

**title** `string`

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

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

Læsbar visningstitel.

**pricing** `object | null`

Hvad denne biomarkør koster, og hvordan den sælges — se [prisobjekter](#prisobjekter).
**Kun** `null`, når din nøgle mangler `prices_view`-scope; en biomarkør, Aniva ikke har
prissat, returneres stadig med `pricing.price_cents: null`.

**pagination** `object`

**Pagineringsfelter**

**total** `number`

Samlet antal rækker, der matcher forespørgslen på tværs af alle sider.

**limit** `number`

Grænse anvendt på denne side. Gengiver `total`, når query-parameteren `limit` blev udeladt
(hele kataloget blev returneret).

**offset** `number`

Offset anvendt på denne side.

**has\_more** `boolean`

`true`, når der findes flere sider.

## Prisobjekter

Prissætning har samme struktur overalt, hvor den optræder — biomarkører, paneler,
[forhåndsvisning](https://docs.anivahealth.com/da/api/appointments/preview-containers.md) af en tid og et [tilbud](https://docs.anivahealth.com/da/api/pricing/quote-cart.md). [Prissætning](https://docs.anivahealth.com/da/concepts/pricing.md) forklarer modellen
bag; dette er feltreferencen.

Alle beløb er i hele cent.

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

Hvad denne koster på **din** prisliste. `0` er en reel pris på nul — varen sælges ikke separat,
og `requires`- eller `positions`-blokken ved siden af viser, hvordan den sælges i stedet. `null`
er noget andet: Aniva har ikke prissat den, den er ikke uden beregning, den kan ikke bestilles,
og den lægger intet til nogen total.

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

Det samme beløb på den vejledende detailprisliste. Altid med; lig med `price_cents`, når din
nøgle allerede bruger detailprislisten.

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

Hvilken af din prislistes to Aniva-satser der prissatte denne markør. Kun med, når den har sin
egen pris.

**positions** `object[]`

De kommercielle tilbud, der indeholder denne biomarkør, billigste først. Med `price_cents: 0` er
dette den eneste måde at bestille den på; med en positiv `price_cents` er det de pakker, den også
indgår i. En position faktureres **én gang** og leveres altid samlet.

**id** `string`

Stabilt positions-id. Kobles med `via_position` på en regning for en tid.

**name** `string`

Positionsnavn vist til partnere.

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

Hvad hele positionen koster på din prisliste, faktureret én gang. `retail_cents` står ved siden af.

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

Hver biomarkør, som positionen leverer, inklusiv den, du forespurgte.

**includes** `number[]`

De øvrige dele ud over den biomarkør, du forespurgte – det, der følger med, når du køber den.

**requires** `object[]`

Til stede, når denne biomarkør er en **ratio**. Når du bestiller den, lægges disse komponenter i kurven til
deres egne priser, og en komponent betales én gang pr. kurv, uanset hvor mange ratioer der bruger den.
Ratioens egen `price_cents` faktureres ud over komponenterne. De fleste ratioer koster `0`. Hver
post indeholder `id`, `name`, `price_cents` og `retail_cents`.

En ratio, hvor ikke alle komponenter er prissat, findes slet ikke i kataloget – den vises aldrig
med `price_cents: null`.

Paneler har kun `price_cents` og `retail_cents`: Et panel har én enkelt katalogpris og ingen
positioner eller komponenter.

## Fejlsvar

| Status | Beskrivelse |
| - | - |
| `400` | Valideringsfejl – f.eks. ingen oprindelse eller to oprindelser, `limit` uden for intervallet eller ukendt/uautoriseret `rate_card`. |
| `403` | Forbudt – mangler scopet `panels_access`. |
| `404` | `location_id` svarer ikke til noget teststed. |
| `500` | Intern serverfejl. |

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