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

# Hae biomarkkeri

> Hae yksittäinen biomarkkeri ID:llä

Palauttaa yksittäisen biomarkkerin sen numeerisen `id`-tunnisteen perusteella. Kätevä, kun haluat muuntaa [Listaa paneelit](https://docs.anivahealth.com/fi/api/panels/list-panels.md) -kutsun tai ajanvaraustietojen palauttamat tunnisteet täysiksi tiedoiksi (nimi, yksikkö, materiaali, kategoria) käymättä läpi koko luetteloa.

Se käyttää samaa luetteloa kuin [Listaa biomarkkerit](https://docs.anivahealth.com/fi/api/biomarkers/list-biomarkers.md), joten lähetä sama alkuperä. Arkistoitu biomarkkeri palauttaa koodin `404`. Samoin käy biomarkkerille, jota et voi tilata kyseiselle alkuperälle avaimesi käytettävissä olevilla laboratorioilla.

Vaatii `panels_access`-käyttöoikeuden. `pricing`-objekti vaatii lisäksi `prices_view`-käyttöoikeuden.

## Polkuparametrit

**id** `number` *required*

Biomarkkerin tunniste.

## Kyselyparametrit

Alkuperällä on kaksi mahdollista muotoa: testauspiste tai kotitestipakkaus. Lähetä tarkalleen yksi. Jos et lähetä kumpaakaan tai lähetät molemmat, pyyntö palauttaa koodin `400`.

> [tab] Testauspiste
>
> **location\_id** `string` *required*
>
> Toimipiste, jossa ajanvarauksen näyte otetaan. Biomarkkeri palauttaa koodin `404`, ellei sen
> tilauksen näytettä oteta vain näyteastioihin, joita kyseisellä toimipisteellä on.

> [tab] Kotitestipakkaus
>
> **home\_kit** `boolean` *required*
>
> Aseta arvoksi `true`. Biomarkkeri palauttaa koodin `404`, ellei kotitestipakkauksia
> käsittelevän laboratorion tilauksen näytettä oteta vain pakkauksen sisältämiin
> näyteastioihin.

**rate\_card** `string`

Ohita `price_cents`-kentän käyttämä hinnasto: `retail` tai sellaisen hinnaston `id`, jota avaimesi saa käyttää. [Hae hinnasto](https://docs.anivahealth.com/fi/api/pricing/get-rate-card.md) palauttaa kyseisen `id`-tunnisteen. Oletuksena käytetään API-avaimesi laskutustilin hinnastoa, muussa tapauksessa vähittäishinnastoa.

## Vastaus

**id** `number`

Pysyvä biomarkkerin tunniste.

**slug** `string`

URL-yhteensopiva tunniste.

**name** `string`

Näyttönimi.

**description** `string | null`

Pitkä kuvaus, jos saatavilla.

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

Ensisijainen kategoria (esim. `Hormones`, `Vitamins`).

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

Toissijainen kategoria.

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

Onko tämä biomarkkeri kliininen mittaus vai geneettinen markkeri.

**material** `string | null`

Vaadittu näytemateriaali (esim. `serum`, `whole_blood`).

**unit** `object | null`

Oletusmittayksikkö. Käytä `id`-tunnistetta viitataksesi [Listaa yksiköt](https://docs.anivahealth.com/fi/api/units/list-units.md)
-luetteloon, jos tarvitset pysyvän tunnisteen nimimuutoksista huolimatta.

**Yksikön kentät**

**id** `number`

Pysyvä mittayksikön tunniste.

**title** `string`

Yksikön vakiomuotoinen nimi (esim. `nmol/L`).

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

Käyttäjäystävällinen näyttönimi.

**pricing** `object | null`

Mitä tämä biomarkkeri maksaa ja miten sitä myydään – katso
[hintaobjektit](https://docs.anivahealth.com/fi/api/biomarkers/list-biomarkers.md#hintaobjektit). `null` **vain**, kun avaimeltasi
puuttuu `prices_view`-käyttöoikeus; biomarkkeri, jota Aniva ei ole hinnoitellut, palautetaan
silti arvolla `pricing.price_cents: null`.

## Virhevastaukset

| Tila | Kuvaus |
| - | - |
| `400` | Validointivirhe – virheellinen `id`, alkuperä puuttuu tai alkuperiä on kaksi, tai tuntematon/luvaton `rate_card`. |
| `403` | Estetty – `panels_access`-käyttöoikeus puuttuu. |
| `404` | Biomarkkeria ei löytynyt, se on arkistoitu tai sitä ei voi tilata kyseiselle alkuperälle. Myös tuntematon `location_id`. |
| `500` | Sisäinen palvelinvirhe. |

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