Hakedişleri Listele

Dönemsel hakedişlerinizi listeler.

GET/v1/settlementsscope:FinanceRead

Yetkilendirme

Bu endpoint FinanceRead scope'u gerektirir. Bkz. İzinler.

Query parametreleri

Sayfalama zorunlu — page, pageSize, orderBy, order alanları gerekir. Detay için Sayfalama sayfasına bakın.

Parametre	Tip	Açıklama
`status`	string	`Draft`, `AwaitingApproval`, `Approved`, `Disputed`, `Paid`
`periodFrom`	date	Bu tarihten sonra biten hakedişler
`periodTo`	date	Bu tarihten önce başlayan hakedişler

orderBy şu alanlardan biri olabilir: CreatedAt, PeriodStart, PeriodEnd, NetAmount.

Dönem filtresi kesişime bakar

periodFrom ve periodTo hakedişin oluşturulma tarihine değil, kapsadığı döneme bakar: verdiğiniz aralıkla kesişen tüm hakedişler döner. Bir hakediş aralığın dışında başlayıp içinde bitiyorsa da listeye girer.

Yanıt formatı

200 OK ile birlikte pagination header'ları (X-Total-Count, X-Page, X-Page-Size, X-Next-Page, X-Prev-Page) döner. Body sadece kayıt dizisini içerir.

[
  {
    "id": "ecd22ec09ab1431981432f5ead392187",
    "periodStart": "2026-05-11",
    "periodEnd": "2026-05-19",
    "grossAmount": 14479.0,
    "commissionAmount": 723.95,
    "commissionVatAmount": 144.79,
    "netAmount": 13490.26,
    "status": "Approved",
    "createdAt": "2026-05-20T03:00:00.559581+00:00"
  }
]

Alanlar

Alan	Tip	Açıklama
`id`	string	Hakediş kimliği
`periodStart` / `periodEnd`	date	Hakediş dönemi (`YYYY-MM-DD`)
`grossAmount`	decimal	Dönemdeki satışların brüt toplamı
`commissionAmount`	decimal	Kesilen komisyon
`commissionVatAmount`	decimal	Komisyonun KDV'si
`netAmount`	decimal	Size kalan net tutar; reklam ücretleri düşüldüğü için negatif olabilir
`status`	string	Hakedişin durumu
`createdAt`	datetime	ISO 8601, UTC

Hata kodları

Code	Anlam
`400`	Sayfalama, `status` ya da dönem aralığı geçersiz
`401`	HMAC kimlik doğrulama hatası
`403`	Gerekli scope eksik
`429`	Hız limiti aşıldı