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

# Iegūt biomarķieri

> Iegūt vienu biomarķieri pēc ID

Atgriež vienu biomarķieri pēc tā skaitliskā `id`. Noderīgi, lai ID no [Paneļu saraksta](https://docs.anivahealth.com/lv/api/panels/list-panels.md) vai pieraksta datiem pārvērstu pilnā informācijā (nosaukums, mērvienība, materiāls, kategorija), nepārmeklējot visu katalogu.

Tas izmanto to pašu katalogu kā [Biomarķieru saraksts](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md), tāpēc nosūti to pašu avotu. Arhivēts biomarķieris atgriež `404`. Tas pats notiek, ja biomarķieri nevari pasūtīt šim avotam laboratorijās, kuras tava atslēga drīkst izmantot.

Nepieciešams `panels_access` tvērums. Objektam `pricing` nepieciešams arī `prices_view` tvērums.

## Ceļa parametri

**id** `number` *required*

Biomarķiera identifikators.

## Vaicājuma parametri

Avotam ir divi varianti: analīžu vieta vai mājas testa komplekts. Nosūti tieši vienu. Ja nenorādīsi nevienu vai norādīsi abus, tiks atgriezts `400`.

> [tab] Analīžu vieta
>
> **location\_id** `string` *required*
>
> Atrašanās vieta, kurā notiek pieraksta asins paņemšana. Biomarķieris atgriež `404`, ja vien
> tā pasūtījumam paraugus neņem tikai tajos trauciņos, kas pieejami šajā atrašanās vietā.

> [tab] Mājas testa komplekts
>
> **home\_kit** `boolean` *required*
>
> Iestati uz `true`. Biomarķieris atgriež `404`, ja vien pasūtījumam mājas testa komplektu
> laboratorijā paraugus neņem tikai tajos trauciņos, kas ir komplektā.

**rate\_card** `string`

Aizstāj cenrādi, kuru izmanto `price_cents`: `retail` vai tāda cenrāža `id`, kuru tava atslēga drīkst izmantot. Šo `id` atgriež [Iegūt cenrādi](https://docs.anivahealth.com/lv/api/pricing/get-rate-card.md). Pēc noklusējuma tiek izmantots tavas API atslēgas norēķinu konta cenrādis, pretējā gadījumā — mazumtirdzniecības cenrādis.

## Atbilde

**id** `number`

Nemainīgs biomarķiera identifikators.

**slug** `string`

URL drošs identifikators.

**name** `string`

Attēlojamais nosaukums.

**description** `string | null`

Detalizēts apraksts, ja pieejams.

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

Galvenā kategorija (piemēram, `Hormones`, `Vitamins`).

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

Sekundārā kategorija.

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

Vai šis biomarķieris ir klīnisks mērījums vai ģenētisks marķieris.

**material** `string | null`

Nepieciešamais parauga materiāls (piemēram, `serum`, `whole_blood`).

**unit** `object | null`

Noklusējuma mērvienība. Izmanto `id`, lai to atrastu [Mērvienību sarakstā](https://docs.anivahealth.com/lv/api/units/list-units.md), ja
nepieciešama nemainīga identifikācija arī pēc nosaukuma maiņas.

**Mērvienības lauki**

**id** `number`

Nemainīgs mērvienības identifikators.

**title** `string`

Kanoniskais mērvienības nosaukums (piemēram, `nmol/L`).

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

Lietotājam draudzīgs attēlojamais nosaukums.

**pricing** `object | null`

Cik šis biomarķieris maksā un kā tas tiek pārdots — skati [cenu
objektus](https://docs.anivahealth.com/lv/api/biomarkers/list-biomarkers.md#cenu-objekti). `null` ir **tikai** tad, kad tavai atslēgai trūkst
`prices_view` tvēruma; biomarķieris, kuram Aniva nav noteikusi cenu, tik un tā tiek atgriezts ar
`pricing.price_cents: null`.

## Kļūdu atbildes

| Statuss | Apraksts |
| - | - |
| `400` | Validācijas kļūda — nederīgs `id`, nav norādīts avots vai norādīti divi avoti, vai nezināms/neautorizēts `rate_card`. |
| `403` | Aizliegts — trūkst `panels_access` tvēruma. |
| `404` | Biomarķieris nav atrasts, ir arhivēts vai nav pasūtāms norādītajā avotā. Arī nezināms `location_id`. |
| `500` | Iekšēja servera kļūda. |

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