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

# Profilleri listele

> Hasta profillerini listele veya e-postaya göre ara

API anahtarının erişebildiği hasta profillerini listele veya tam e-posta adresiyle bir profil ara.

`email` verildiğinde uç nokta, asıl oturum açma e-postası üzerinde Redis önbellekli tam
eşleşme araması yapar ve 0 veya 1 sonuç döndürür; bu durumda `limit` ve `offset` yok sayılır.
Verilmediğinde ise uç nokta, API anahtarının erişim bağlamına göre sayfalanmış bir profil
listesi döndürür.

E-posta eşleştirmesi büyük/küçük harfe duyarsız ve tamdır — alt dize ve ön ek eşleştirmeleri
desteklenmez. Yalnızca asıl oturum açma e-postası kontrol edilir; `work_email` gibi alternatif
adresler dikkate alınmaz.

`profiles_view` veya `impersonate` kapsamı gerekir.

## İstek

### Sorgu parametreleri

**email** `string`

Tam e-posta adresine göre filtrele (büyük/küçük harfe duyarsız). Ayarlandığında 0 veya 1 sonuç
döndürür ve `limit`/`offset` yok sayılır. Arama, dizinlenmiş SQL yedekli bir Redis önbellekli
ters dizin üzerinden yapılır.

**limit** `integer` (default: 100)

Döndürülecek en fazla profil sayısı. Varsayılan 100, en fazla 500. `email` ayarlandığında yok sayılır.

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

Sayfalama için atlanacak profil sayısı. Varsayılan 0. `email` ayarlandığında yok sayılır.

## Yanıt

İşlem başarılı olursa API, profil nesnelerinden oluşan bir diziyle birlikte `200 OK` döndürür.
Her öğenin yapısı [Profili al](https://docs.anivahealth.com/tr/api/profiles/get-profile.md) ile eşleşir.

**id** `string` *required*

Benzersiz profil kimliği (UUID).

**handle** `string`

Profil tanıtıcısı 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'e göre biyolojik cinsiyet (`0` = bilinmiyor, `1` = erkek, `2` = kadın). `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: `en`, `bg`, `ca`, `cs`, `da`, `de`, `el`, `es`, `et`, `fi`, `fr`, `ga`, `hr`, `hu`, `is`, `it`, `lb`, `lt`, `lv`, `mt`, `nl`, `no`, `pl`, `pt`, `ro`, `ru`, `sk`, `sl`, `sr`, `sv`, `tr` veya `uk`.

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

Bu profilin işlemsel (programatik) e-postaları alıp almayacağı. Hiç ayarlanmadığında `null`.

**created\_at** `string`

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

**updated\_at** `string`

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

## Davranış notları

* Hem e-postayla eşleşen profil olmadığında hem de erişim bağlamının dışında bir eşleşme
  olduğunda boş bir dizi döndürülür. Bu kasıtlıdır — uç noktanın okuyamadığın profillerin
  varlığını sızdırmasını önler.
* Oluşturma akışı önbelleği eşzamanlı olarak doldurduğundan, yeni oluşturulan profiller `email`
  ile hemen bulunabilir.
* Filtrelenmemiş liste `created_at` alanına göre azalan sırada (en yeni önce) sıralanır ve
  `limit` ile `offset` üzerinden sayfalanır.

## Tekrarlanan çağrılar

Aniva bu uç noktanın yanıtını her API anahtarı için 5 dakika boyunca saklar. Bu süre içinde
yapılan yinelenen bir çağrı saklanan yanıtı alır. `Cache-Status` ve `Age` başlıkları yanıtın
saklandığını ve ne kadar eski olduğunu gösterir.

Bir değişiklikten anında haberdar olmak için `profile.created`, `profile.updated` ve `profile.deleted` webhook olaylarına abone ol.
[Tekrarlanan okumalar](https://docs.anivahealth.com/tr/concepts/webhooks.md#tekrarlanan-okumalar) bölümüne bak.

## Hata yanıtları

| Durum | Açıklama |
| - | - |
| `400` | Doğrulama hatası — geçersiz e-posta biçimi veya aralık dışında `limit`/`offset`. |
| `403` | Erişim reddedildi — API anahtarın gerekli kapsama (`profiles_view`/`impersonate`) sahip değil. |
| `500` | Dahili sunucu hatası. |

```bash cURL (lookup by email) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/profiles?email=maria.schmidt@example.com' \
  --header 'x-api-key: YOUR_API_KEY'
```

```bash cURL (paginated list) theme={null}
curl --request GET \
  --url 'https://anivahealth.com/api/v1/profiles?limit=50&offset=0' \
  --header 'x-api-key: YOUR_API_KEY'
```

```json 200 theme={null}
[
  {
    "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": "2026-04-01T11:05:00Z"
  }
]
```

```json 200 (no match) theme={null}
[]
```

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


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