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

# Biyobelirteci getir

> ID ile tek bir biyobelirteci getir

Sayısal `id` değerine göre tek bir biyobelirteç döndürür. [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) veya randevu verilerinden dönen ID'leri tüm kataloğu taramadan eksiksiz ayrıntılara (ad, birim, materyal, kategori) çözümlemek için kullanışlıdır.

[Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) ile aynı kataloğu sunar, bu nedenle aynı kaynağı gönder. Arşivlenmiş bir biyobelirteç `404` döndürür. Anahtarının kullanabileceği laboratuvarlarla o kaynakta sipariş edemeyeceğin bir biyobelirteç için de aynı durum geçerlidir.

`panels_access` kapsamını gerektirir. `pricing` nesnesi ayrıca `prices_view` kapsamını gerektirir.

## Yol parametreleri

**id** `number` *required*

Biyobelirteç tanımlayıcısı.

## Sorgu parametreleri

Kaynak iki biçimden biridir: test konumu veya evde test kiti. Tam olarak birini gönder. Hiçbirini veya ikisini birden göndermek `400` döndürür.

> [tab] Test konumu
>
> **location\_id** `string` *required*
>
> Randevuda kan almanın yapıldığı konum. Siparişinin numunesi yalnızca o konumda bulunan
> kaplara alınmıyorsa biyobelirteç `404` döndürür.

> [tab] Evde test kiti
>
> **home\_kit** `boolean` *required*
>
> `true` olarak ayarla. Evde test kiti laboratuvarındaki bir siparişin numunesi yalnızca kitin
> içerdiği kaplara alınmıyorsa biyobelirteç `404` döndürür.

**rate\_card** `string`

`price_cents` alanının hangi fiyat tarifesini kullanacağını geçersiz kıl: `retail` veya anahtarının kullanabileceği bir fiyat tarifesinin `id` değeri. [Fiyat tarifesini getir](https://docs.anivahealth.com/tr/api/pricing/get-rate-card.md) bu `id` değerini döndürür. Varsayılan olarak API anahtarının faturalandırma hesabındaki tarifeyi, yoksa perakende tarifesini kullanır.

## Yanıt

**id** `number`

Sabit biyobelirteç tanımlayıcısı.

**slug** `string`

URL uyumlu tanımlayıcı.

**name** `string`

Görünen ad.

**description** `string | null`

Varsa uzun açıklama.

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

Birincil kategori (ör. `Hormones`, `Vitamins`).

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

İkincil kategori.

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

Bu biyobelirtecin klinik bir ölçüm mü yoksa genetik bir belirteç mi olduğu.

**material** `string | null`

Gerekli numune materyali (ör. `serum`, `whole_blood`).

**unit** `object | null`

Varsayılan ölçüm birimi. Yeniden adlandırmalarda sabit kimliğe ihtiyacın varsa `id` değerini
[Birimleri listele](https://docs.anivahealth.com/tr/api/units/list-units.md) ile eşleştirmek için kullan.

**Birim alanları**

**id** `number`

Sabit ölçüm birimi tanımlayıcısı.

**title** `string`

Standart birim başlığı (ör. `nmol/L`).

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

Okunabilir görünüm başlığı.

**pricing** `object | null`

Bu biyobelirtecin fiyatı ve nasıl satıldığı — bkz. [fiyat
nesneleri](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md#fiyat-nesneleri). **Yalnızca** anahtarında
`prices_view` kapsamı eksik olduğunda `null` olur; Aniva'nın fiyatlandırmadığı bir biyobelirteç
yine de `pricing.price_cents: null` ile döndürülür.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — geçersiz `id`, kaynak belirtilmemiş veya iki kaynak verilmiş ya da bilinmeyen/yetkisiz `rate_card`. |
| `403` | Yasak — `panels_access` kapsamı eksik. |
| `404` | Biyobelirteç bulunamadı, arşivlendi veya bu kaynakta sipariş edilemiyor. Bilinmeyen bir `location_id` için de döner. |
| `500` | Dahili sunucu hatası. |

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