# GET /v1/payouts

عرض الدفعات

اعرض طلبات الدفع الخاصة بالناشر وحالتها. تتطلب الصلاحية `publisher:read` (مفتاح API أو جلسة ويب). فئة حد المعدل: `read`.

- الصلاحية المطلوبة: `publisher:read`
- حد المعدل: `read` — 120 طلبًا لكل نافذة مدتها 60 ثانية لكل مفتاح API أو جلسة ويب

## المعاملات

لا معاملات.

## الاستجابة

```
{ amount: string; decided_at: string | null; id: integer; method: "paypal" | "usdt" | "bank"; notes: string | null; paid_at: string | null; requested_at: string; status: "requested" | "approved" | "paid" | "rejected"; tx_ref: string | null }[]
```

## الأخطاء

تعيد المسارات الخاضعة لحد المعدل الترويسات `RateLimit-Limit` و`RateLimit-Remaining` و`RateLimit-Reset` (عدد الثواني حتى انتهاء النافذة)؛ وتحمل الاستجابة 429 أيضًا `Retry-After`. قد تغيب الترويسات أثناء عدم توفر المحدّد مؤقتًا (وتمرّر الطلبات حينئذ).

| الحالة | المعنى |
|---|---|
| 401 | مفتاح API مفقود أو غير صالح أو ملغى. |
| 403 | ينقص المفتاح الصلاحية المطلوبة، أو العملية غير مسموح بها لهذا الطرف. |
| 429 | تم تجاوز حد المعدل؛ انتظر `Retry-After` ثانية. |

وثائق HTML: https://agimone.com/ar/developers/api/#list-payouts
API 2026-10
