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

# Randevuyu getir

> ID ile bir kan alma randevusunu getir

Gömülü hasta profili dahil olmak üzere tek bir kan alma randevusunu UUID'sine göre getir. Randevu durumunu kontrol etmek, planlama ayrıntılarını doğrulamak veya ilişkili profil verilerini almak için bu uç noktayı kullan.

`appointments_view` veya `appointments_schedule` kapsamını gerektirir.

## İstek

### Yol parametreleri

**id** `string` *required*

Getirilecek randevunun benzersiz tanımlayıcısı (UUID).

## Yanıt

Başarılı olduğunda API, randevu ve gömülü profiliyle birlikte `200 OK` döndürür.

**id** `string` *required*

Benzersiz randevu tanımlayıcısı (UUID).

**profile\_id** `string` *required*

Bu randevunun ait olduğu profilin UUID'si.

**location\_id** `string`

Kan almanın gerçekleştiği test konumunun UUID'si.

**scheduled\_at** `string`

UTC anı olarak planlanan randevu tarih ve saati (`Z` son ekli ISO 8601, ör.
`2026-05-15T10:30:00Z`). `null` olabilir.

**status** `string` *required*

Mevcut randevu durumu. `pending`, `confirmed`, `blood_drawn` veya `cancelled` değerlerinden biri.
Laboratuvar sonuçlarının tamamlanma ayrıntıları [Sonuçları getir](https://docs.anivahealth.com/tr/api/appointments/get-results.md)
üzerinden; daha ayrıntılı gönderi ilerleyişi ise satır içi `shipments` dizisindeki (aşağıya bak)
her kaydın [Gönderiyi getir](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) ile takip edilmesiyle elde edilir.

**cancellation\_reason** `string`

Randevu iptal edildiğinde kaydedilen serbest metin neden (ör. gelmeme, geç iptal,
'Başarısız. Tekrar gerekli'). `status` değeri `cancelled` değilse `null` olur.

**results\_ready\_emails** `string[]` *required*

Tüm laboratuvar sonuçları kesinleştiğinde her birine bir e-posta gönderilen, küçük harfe çevrilmiş adresler. Kapalıyken boştur. Bkz.
[Sonuçlar hazır e-postaları](https://docs.anivahealth.com/tr/concepts/results.md#sonuclar-hazir-e-postalari).

**draw\_method** `string` *required*

Kan alma yöntemi: `capillary` (parmak ucundan veya üst koldan, mikrotüplere) ya da `venous` (damardan,
tüplere). Randevuda belirlenen yöntemdir; belirlenmemişse [konumun](https://docs.anivahealth.com/tr/concepts/locations.md)
`default_draw_method` değeridir. Kan almadan sonra kullanılan yöntemdir.

**created\_at** `string` *required*

Randevunun oluşturulduğu zamanın ISO 8601 zaman damgası.

**updated\_at** `string`

Son güncellemenin ISO 8601 zaman damgası. `null` olabilir.

**profile** `object` *required*

Bu randevuyla ilişkili hasta profili.

**profil**

**id** `string`

Benzersiz profil tanımlayıcısı (UUID).

**handle** `string`

Profil rumuzu veya kullanıcı adı. `null` olabilir.

**first\_name** `string`

Ad. `null` olabilir.

**last\_name** `string`

Soyad. `null` olabilir.

**email** `string`

E-posta adresi. `null` olabilir.

**phone** `string`

E.164 biçiminde telefon numarası. `null` olabilir.

**sex** `integer`

ISO/IEC 5218 standardına göre biyolojik cinsiyet. `null` olabilir.

**date\_of\_birth** `string`

`YYYY-MM-DD` biçiminde doğum tarihi. `null` olabilir.

**height** `number`

Santimetre cinsinden boy. `null` olabilir.

**weight** `number`

Kilogram cinsinden kilo. `null` olabilir.

**language** `string`

Tercih edilen dil: [Profil oluştur](https://docs.anivahealth.com/tr/api/profiles/create-profile.md) sayfasındaki 32 koddan biri.

**transactional\_emails\_enabled** `boolean`

Bu profilin işlemsel (programatik) e-postalar alıp almadığı. `null` olabilir.

**created\_at** `string`

Profilin oluşturulduğu zamanın ISO 8601 zaman damgası.

**updated\_at** `string`

Son profil güncellemesinin ISO 8601 zaman damgası. `null` olabilir.

**panels** `AppointmentPanel[]` *required*

Şu anda bu randevuya bağlı paneller. İptal edilen bağlantılar hariçtir. Panel
ayrıntılarını (ad, biyobelirteçler) [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) üzerinden incele.

**Eklenen panel alanları**

**panel\_id** `string`

Panel UUID'si — [Panelleri listele](https://docs.anivahealth.com/tr/api/panels/list-panels.md) ile eşleştir.

**added\_at** `string`

Panelin bu randevuya ilk eklendiği zamanın ISO 8601 zaman damgası.

**individual\_biomarkers** `AppointmentIndividualBiomarker[]` *required*

Herhangi bir panel dışında bu randevuya eklenen tekil biyobelirteçler (bkz. [Özel
biyobelirteç ekle](https://docs.anivahealth.com/tr/api/appointments/add-individual-biomarkers.md)). Görüntüleme verileri için her `biomarker_id`
değerini [Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) ile eşleştir.

**Tekil biyobelirteç alanları**

**biomarker\_id** `integer`

Biyobelirteç tanımlayıcısı —
[Biyobelirteçleri listele](https://docs.anivahealth.com/tr/api/biomarkers/list-biomarkers.md) ile eşleştir.

**added\_at** `string`

Biyobelirtecin bu randevuya ilk eklendiği zamanın ISO 8601 zaman damgası.

**shipments** `AppointmentShipmentLink[]` *required*

Bu randevuya bağlı gönderiler, en eski bağlantıdan başlayarak sıralanır. Bağlı gönderi olmadığında
boş dizidir. Tam gönderi verisi (durum, takip numarası, durum güncellemeleri vb.) için her `id`
değerini [Gönderiyi getir](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) ile eşleştir.

**Gönderi bağlantısı alanları**

**id** `string`

Gönderi referans tanımlayıcısı —
[Gönderiyi al](https://docs.anivahealth.com/tr/api/shipments/get-shipment.md) ile eşleştir.

**added\_at** `string`

Gönderinin bu randevuya ilk bağlandığı zamanın ISO 8601 zaman damgası.

**lab\_codes** `string[]` *required*

Bu randevu için tarama sırasına göre kaydedilen laboratuvar kodları (tüp barkodları). Kan alma
onaylanana kadar boştur. Venöz kan almada her tüpe basılı tek bir kod bulunur; kapiler kan almada
mikrotüp başına bir kod bulunur. [Sonuçları al](https://docs.anivahealth.com/tr/api/appointments/get-results.md) üzerindeki sonuçlar ve belgeler
bu kodlara `lab_code` üzerinden başvurur.

## Tekrarlanan çağrılar

Aniva, bu uç noktanın yanıtını her API anahtarı için 15 dakika saklar. Bu süre içindeki tekrarlanan
bir çağrı, randevu değişmediği sürece saklanan yanıtı alır. Bir değişiklikten sonra güncel bir
yanıt alırsın. `Cache-Status` ve `Age` başlıkları, yanıtın saklandığını ve ne kadar eski
olduğunu gösterir.

Bir değişikliği anında öğrenmek için `appointment.created`, `appointment.rescheduled` ve örneğin `appointment.confirmed` gibi her durumun webhook olaylarına abone ol.
Bkz. [Tekrarlanan okumalar](https://docs.anivahealth.com/tr/concepts/webhooks.md#tekrarlanan-okumalar).

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Geçersiz kimlik biçimi — verilen değer geçerli bir UUID değil. |
| `403` | Yasak — API anahtarının bu işleme erişimi yok. |
| `404` | Randevu bulunamadı. |
| `500` | İç sunucu hatası. |

```bash cURL theme={null}
curl --request GET \
  --url https://anivahealth.com/api/v1/appointments/c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
{
  "id": "c9f3e2a1-7d6b-4c5e-b3a2-1f0e9d8c7b6a",
  "profile_id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
  "location_id": "b7e2d1f5-3c4a-4e8b-a2f1-9d0c1e2f3a4b",
  "scheduled_at": "2026-05-15T10:30:00Z",
  "status": "confirmed",
  "cancellation_reason": null,
  "results_ready_emails": [],
  "draw_method": "venous",
  "created_at": "2026-04-01T09:45:00Z",
  "updated_at": null,
  "profile": {
    "id": "a3f1c2d4-8b7e-4f2a-9c1d-2e3f4a5b6c7d",
    "handle": null,
    "first_name": "Maria",
    "last_name": "Schmidt",
    "email": "maria.schmidt@example.com",
    "phone": "+4930123456789",
    "sex": 2,
    "date_of_birth": "1985-03-22",
    "height": 168,
    "weight": 65,
    "language": "de",
    "transactional_emails_enabled": true,
    "created_at": "2026-04-01T09:14:32Z",
    "updated_at": null
  },
  "panels": [
    {
      "panel_id": "f1c2d4a3-7b8e-4f2a-9c1d-2e3f4a5b6c7d",
      "added_at": "2026-04-01T09:50:00Z"
    }
  ],
  "individual_biomarkers": [
    {
      "biomarker_id": 42,
      "added_at": "2026-04-01T09:52:00Z"
    }
  ],
  "shipments": [
    {
      "id": "P2611194821",
      "added_at": "2026-04-15T07:00:00Z"
    }
  ],
  "lab_codes": []
}
```

```json 400 theme={null}
{
  "error": "Invalid appointment ID format"
}
```

```json 404 theme={null}
{
  "error": "Appointment not found"
}
```


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