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

# Hämta biomarkör

> Hämta en enskild biomarkör via ID

Returnerar en enskild biomarkör utifrån dess numeriska `id`. Användbart för att slå upp de ID:n som returneras av [Lista paneler](https://docs.anivahealth.com/sv/api/panels/list-panels.md) eller bokningsdata till fullständig information (namn, enhet, material, kategori) utan att gå igenom hela katalogen.

Den använder samma katalog som [Lista biomarkörer](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md), så skicka samma ursprung. En arkiverad biomarkör returnerar `404`. Det gör även en biomarkör som du inte kan beställa för det ursprunget med de labb din nyckel får använda.

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

## Sökvägsparametrar

**id** `number` *required*

Biomarkörens identifierare.

## 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 bokningen sker. Biomarkören returnerar `404` om dess
> beställning inte enbart tas i provkärl som finns på platsen.

> [tab] Hemtestkit
>
> **home\_kit** `boolean` *required*
>
> Sätt till `true`. Biomarkören returnerar `404` om en beställning hos ett labb för hemtestkit
> inte enbart tas i de provkärl som ett kit innehåller.

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

## Svar

**id** `number`

Stabil identifierare för biomarkören.

**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](https://docs.anivahealth.com/sv/api/biomarkers/list-biomarkers.md#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`.

## Felsvar

| Status | Beskrivning |
| - | - |
| `400` | Valideringsfel — ogiltigt `id`, inget eller två ursprung, eller okänd/obehörig `rate_card`. |
| `403` | Förbjudet — saknar scopet `panels_access`. |
| `404` | Biomarkören hittades inte, är arkiverad eller kan inte beställas för ursprunget. Även vid okänt `location_id`. |
| `500` | Internt serverfel. |

```bash cURL theme={null}
curl --url 'https://anivahealth.com/api/v1/biomarkers/42?home_kit=true' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "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"
  }
}
```

```json 200 (sold only inside a position) theme={null}
{
  "id": 77,
  "slug": "mean-platelet-volume",
  "name": "Mean Platelet Volume (MPV)",
  "description": null,
  "primary_category": "Haematology",
  "secondary_category": null,
  "type": "clinical",
  "material": "whole_blood",
  "unit": { "id": 7, "title": "fL", "display_title": null },
  "pricing": {
    "price_cents": 0,
    "retail_cents": 0,
    "positions": [
      {
        "id": "3f1a8c22-64bd-4e57-8a90-1c2d3e4f5a6b",
        "name": "Blood Count (extended)",
        "price_cents": 460,
        "retail_cents": 529,
        "biomarker_ids": [71, 72, 73, 77],
        "includes": [71, 72, 73]
      }
    ]
  }
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.