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

# Biyobelirteçleri listele

> Biyobelirteç kataloğuna göz at

API anahtarının tek bir kaynakta sipariş edebileceği biyobelirteçlerin sayfalandırılmış kataloğunu döndürür. Bunları [randevulara](https://docs.anivahealth.com/tr/api/appointments/add-individual-biomarkers.md) veya [evde test kitlerine](https://docs.anivahealth.com/tr/api/home-kit-orders/add-individual-biomarkers.md) ekle. Arşivlenmiş biyobelirteçler hariç tutulur.

Anahtarının kullanabileceği bir laboratuvardaki sipariş bir biyobelirteci sunuyorsa ve siparişin numunesi yalnızca kaynağın elindeki kaplara alınıyorsa o biyobelirteç listelenir. Belirleyici olan analit türü değil, numune tüpleridir.

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

## İstek

### 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*
>
> Randevularda kan almanın yapıldığı konum. Siparişinin numunesi yalnızca o konumda bulunan
> kaplara alınıyorsa biyobelirteç listelenir. [Konumları listele](https://docs.anivahealth.com/tr/api/locations/list-locations.md)
> ile eşleştir.

> [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ınıyorsa biyobelirteç listelenir: kapiler serum ve EDTA, kuru kan damlası,
> idrar ve sürüntü. Yalnızca venöz biyobelirteçler dışarıda bırakılı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.
`retail_cents` her zaman perakende tarifesidir.

**limit** `number`

Döndürülecek en fazla sonuç sayısı (1–1.000). Eşleşen tüm kataloğu döndürmek için belirtme —
sınırlıdır (en fazla birkaç bin satır). Belirtilmediğinde `pagination.limit` alanı `total`
değerini yansıtır.

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

Sayfalandırma ofseti. ≥ 0 olmalıdır.

## Yanıt

**data** `Biomarker[]`

Sorguyla eşleşen biyobelirteç dizisi.

**Biyobelirteç alanları**

**id** `number`

Sabit biyobelirteç tanımlayıcısı — bunu [Özel biyobelirteç
ekle](https://docs.anivahealth.com/tr/api/appointments/add-individual-biomarkers.md) ile gönder.

**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](#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.

**pagination** `object`

**Sayfalandırma alanları**

**total** `number`

Tüm sayfalarda sorguyla eşleşen toplam satır sayısı.

**limit** `number`

Bu sayfaya uygulanan limit. `limit` sorgu parametresi belirtilmediğinde (tüm katalog
döndürüldüğünde) `total` değerini yansıtır.

**offset** `number`

Bu sayfaya uygulanan ofset.

**has\_more** `boolean`

Daha fazla sayfa mevcut olduğunda `true` olur.

## Fiyat nesneleri

Fiyatlandırma göründüğü her yerde tek bir biçime sahiptir — biyobelirteçler, paneller, randevu
[önizlemesi](https://docs.anivahealth.com/tr/api/appointments/preview-containers.md) ve [fiyat teklifi](https://docs.anivahealth.com/tr/api/pricing/quote-cart.md). [Fiyatlandırma](https://docs.anivahealth.com/tr/concepts/pricing.md) bunun arkasındaki
modeli açıklar; burası ise alan referansıdır.

Her tutar tam sayı sent cinsindendir.

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

**Senin** fiyat tarifendeki fiyatı. `0` gerçek bir sıfır fiyattır — öğe tek başına satılmaz ve
bunun yerine nasıl satıldığını yanındaki `requires` veya `positions` bloğu belirtir. `null`
farklıdır: Aniva bunu fiyatlandırmamıştır, bedelsiz değildir, sipariş edilemez ve hiçbir toplama
eklenmez.

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

Önerilen perakende tarifesindeki aynı tutar. Her zaman bulunur; anahtarın zaten perakende
tarifesindeyse `price_cents` değerine eşittir.

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

Tarifendeki iki Aniva oranından hangisinin bu belirteci fiyatlandırdığı. Yalnızca kendi başına bir
fiyatı olduğunda bulunur.

**positions** `object[]`

Bu biyobelirteci içeren ticari teklifler, en ucuzdan başlayarak. `price_cents: 0` olduğunda bunu
sipariş etmenin tek yolu bunlardır; pozitif bir `price_cents` değeri olduğunda ise ait olduğu
paketlerdir. Bir pozisyon **bir kez** faturalandırılır ve her zaman bütün olarak teslim edilir.

**id** `string`

Sabit kalem tanımlayıcısı. Randevu faturasındaki `via_position` alanı ile eşleşir.

**name** `string`

İş ortağına gösterilen kalem adı.

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

Tüm kalemin kartındaki ücreti, tek sefer faturalandırılır. Yanında `retail_cents` yer alır.

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

Sorguladığın biyobelirteç dahil olmak üzere kalemin sunduğu tüm biyobelirteçler.

**includes** `number[]`

Sorguladığın biyobelirteç dışındaki üyeler — satın aldığında birlikte gelenler.

**requires** `object[]`

Bu biyobelirteç bir **oran** olduğunda bulunur. Sipariş ettiğinde bu bileşenler kendi
fiyatlarıyla sepete eklenir ve kaç oran ona dayanırsa dayansın bir bileşen sepet başına bir kez
ödenir. Oranın kendi `price_cents` tutarı, bileşenlerine ek olarak faturalandırılır. Çoğu oranın
ücreti `0` olur. Her kayıt `id`, `name`, `price_cents` ve `retail_cents` alanlarını içerir.

Tüm bileşenleri fiyatlandırılmamış bir oran katalogda hiç yer almaz — hiçbir zaman
`price_cents: null` ile görünmez.

Paneller yalnızca `price_cents` ve `retail_cents` taşır: bir panelin tek bir katalog fiyatı vardır,
kalemleri veya bileşenleri yoktur.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — örn. kaynak yok veya iki kaynak var, `limit` aralık dışında ya da bilinmeyen/yetkisiz `rate_card`. |
| `403` | Yasak — `panels_access` kapsamı eksik. |
| `404` | `location_id` herhangi bir test konumuna karşılık gelmiyor. |
| `500` | Dahili sunucu hatası. |

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