# GET /v1/disputes

Liệt kê khiếu nại

Danh sách khiếu nại của nhà xuất bản, kèm trạng thái và hạn phản hồi đầu 48 giờ, hạn kết luận 7 ngày. Cần quyền `publisher:read`. Tầng giới hạn tốc độ: `read`.

- Quyền cần có: `publisher:read`
- Giới hạn tốc độ: `read` — 120 yêu cầu mỗi cửa sổ 60 giây cho mỗi API key hoặc phiên web

## Tham số

Không có tham số.

## Phản hồi

```
{ amount_returned: string | null; first_response_at: string | null; first_response_due_at: string; id: integer; opened_at: string; overdue: boolean; resolution: "upheld" | "rejected" | "partial" | null; resolve_due_at: string; resolved_at: string | null; status: "open" | "answered" | "resolved"; subject_id: integer | null; subject_type: "hold" | "adjustment" | "ivt" | "zone_quality" | "payout" | "other" }[]
```

## Lỗi

Các route có giới hạn tốc độ trả `RateLimit-Limit`, `RateLimit-Remaining`, `RateLimit-Reset` (số giây tới hết cửa sổ); phản hồi 429 có thêm `Retry-After`. Header có thể vắng khi bộ giới hạn tạm thời không sẵn sàng (khi đó yêu cầu vẫn được cho qua).

| Mã | Ý nghĩa |
|---|---|
| 401 | Thiếu, sai hoặc đã thu hồi API key. |
| 403 | Key thiếu quyền cần có, hoặc thao tác không được phép với tác nhân này. |
| 429 | Vượt giới hạn tốc độ; chờ `Retry-After` giây. |

Tài liệu HTML: https://agimone.com/vi/developers/api/#list-disputes
API 2026-10
