KYC Gruplarını Listele

Bir KYC tokenında bulunan KYC gruplarını en yeniden eskiye listeler. KYC tokenının kendisi aranmaz: hiçbir KYC tokenına karşılık gelmeyen bir id boş sayfa döner.

Bir grup, oluşturma isteği kabul edildiği anda görünür (zincir üzerindeki oluşturma başarısız olsa da kalır) ve silme işlemi onaylandığında listeden düşer. Yalnızca platform sahibi (kök) düğüm çağırabilir.

Gerekli izin: kyc:group:view

İstek

GET /v2/admin/kycs/{kyc_token_id}/groups

Parametreler

Ad	Tip	Konum	Açıklama
kyc_token_id	string	path	Zorunlu. KYC tokenının id değeri (KYC Tokenlarını Listele yanıtından)
search	string	query	İsteğe bağlı. Grup adının bir parçası; harf büyüklüğü yok sayılarak eşleşir
page	integer	query	Zorunlu. Sayfa numarası, 1'den başlar
per_page	integer	query	Zorunlu. Sayfa başına kayıt, 1–100

Başlıklar

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

Örnek

curl --request GET \
  --url '{{baseUrl}}/v2/admin/kycs/68c4a1f2b9e3d70012a5c3e8/groups?page=1&per_page=10' \
  --header 'Authorization: Bearer <access_token>'

Yanıt

Durum 200.

{
  "data": [
    {
      "id": "68d2e7a9c1b4f30045e1a9b2",
      "kyc_token_id": "68c4a1f2b9e3d70012a5c3e8",
      "group_id": 12,
      "name": "Accredited Investors",
      "created_at": "2026-10-02T09:14:31.512Z",
      "updated_at": "2026-10-02T09:14:31.512Z"
    }
  ],
  "total": 1,
  "page": 1,
  "per_page": 10
}

Yanıt Alanları

Alan	Tip	Açıklama
data	array	Bu sayfadaki gruplar, en yeniden eskiye
data[].id	string	Grubun id'si. Tüm path'ler ve token kuralları bu değeri kullanır
data[].kyc_token_id	string	Grubun bulunduğu KYC tokenı. Gruplar KYC tokenına bağlanmadan önce oluşturulmuş gruplarda yer almaz
data[].group_id	integer	Grubun zincir üzerindeki numarası; platform genelinde benzersizdir
data[].name	string	Grubun adı
data[].created_at	string	Grubun oluşturulduğu zaman (ISO 8601)
data[].updated_at	string	Grubun son değiştiği zaman (ISO 8601)
total	integer	Filtrelere uyan kayıt sayısı
page	integer	Sayfa numarası
per_page	integer	Sayfa boyutu

Hatalar

Durum	Kod	Açıklama
400	10015	Doğrulama başarısız — details alanına bakın
400	10016	kyc_token_id geçerli bir id değil
403	10005 (domain 2)	Düğümünüz platform sahibi (kök) düğüm değil

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