Kullanıcıları Listele

Kullanıcıların bir sayfasını en yeniden eskiye döndürür. search, name, surname ve email alanlarında aynı anda aranan tek bir serbest metin terimidir (büyük/küçük harf duyarsız alt dize; alan bazında eşleşir, bu yüzden tam ad yalnızca tek bir alanda saklanıyorsa eşleşir). Silinmiş (soft-delete) kullanıcılar listelenmez. Kimseyle eşleşmeyen bir arama hata değil, boş bir sayfa döndürür.

Satırlar Kullanıcıyı ID ile Getir ile aynı biçimdedir. Kullanıcı adres taşımaz: adresler cüzdanlara aittir, onları Kullanıcı Cüzdanlarını Listele ile okuyun.

Gerekli izin: user:view

İstek

GET /v2/users

Parametreler

Ad	Tip	Konum	Açıklama
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100
search	string	query	İsteğe bağlı. Ad, soyad ve e-postada aranan serbest metin. Tüm kullanıcıları listelemek için göndermeyin

Başlıklar

Ad	Açıklama
Authorization	Zorunlu. Bearer <access_token>

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/users?page=1&per_page=10&search=durdu' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

{
  "data": [
    {
      "id": "6a87455ad5f439809d488ac3",
      "external_id": null,
      "name": "Burkay",
      "surname": "Durdu",
      "email": "burkay.durdu@rudiq.com",
      "identity_number": "11111111111",
      "status": 0,
      "created_at": "2026-08-21T09:14:02.511Z",
      "kyc": null
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Bu sayfadaki kullanıcılar. Eşleşme yoksa boş dizi
data[].id	string	Kullanıcı ID'si
data[].external_id	string | null	Migration sırasında verilen opak tanımlayıcı; verilmediyse null
data[].name	string	Ad; saklanmadıysa boş string
data[].surname	string	Soyad; saklanmadıysa boş string
data[].email	string	E-posta; yalnızca external_id ile aktarılan kullanıcılarda boş string
data[].identity_number	string	Kimlik numarası; saklanmadıysa boş string
data[].status	integer	0 = aktif, 1 = pasif (Kullanıcı Durumunu Güncelle ile ayarlanır)
data[].created_at	string	ISO 8601 oluşturulma zamanı
data[].kyc	null	Her zaman null. KYC cüzdan bazında tutulur: Kullanıcı Cüzdanını Getir ile okuyun
total	integer	Filtreye uyan kullanıcı sayısı
page	integer	İstenen sayfa
per_page	integer	İstenen sayfa boyutu

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama hatası (page / per_page eksik ya da aralık dışı) — details alanına bakın

Hata biçimi ve ortak kodlar için Hatalar sayfasına bakın.