Skip to main content
GET
/
v2
/
order-disputes
List order disputes
curl --request GET \
  --url https://api.gameboost.com/v2/order-disputes \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 123,
      "orderable_type": "account_order",
      "orderable_id": 123,
      "buyer_id": 123,
      "status": "waiting_for_seller",
      "progress_path": "waiting_for_seller",
      "reason": "account_not_as_described",
      "explanation": "<string>",
      "preferred_resolution": "other",
      "preferred_resolution_note": "<string>",
      "escalation_reason": "seller_requested",
      "closure_reason": "seller_accepted",
      "outcome": "refund",
      "seller_response_due_at": 123,
      "buyer_response_due_at": 123,
      "active_due_at": 123,
      "is_active_deadline_expired": true,
      "dispute_timing_hours": 123,
      "locked_at": 123,
      "closed_at": 123,
      "created_at": 123,
      "updated_at": 123
    }
  ],
  "meta": {
    "current_page": 123,
    "from": 123,
    "last_page": 123,
    "per_page": 123,
    "to": 123,
    "total": 123
  },
  "links": {
    "first": "<string>",
    "last": "<string>",
    "prev": "<string>",
    "next": "<string>"
  }
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

filter[id]
string

Filter by dispute ID.

Example:

"3,6,9"

filter[status]
enum<string>

Filter by dispute status.

Available options:
waiting_for_seller,
waiting_for_buyer,
pending_admin_resolution,
escalated,
closed
Example:

"waiting_for_seller"

filter[orderable_type]
enum<string>

Filter by orderable type.

Available options:
account_order,
item_order,
currency_order
Example:

"account_order"

filter[orderable_id]
string

Filter by orderable ID.

Example:

110237

filter[active]
boolean

Filter by open (true) or closed (false) disputes.

filter[created_at]
string

Filter by created at. Supports single date (YYYY-MM-DD) or date range (YYYY-MM-DD,YYYY-MM-DD).

Example:

"2019-08-14,2025-12-31"

filter[updated_at]
string

Filter by updated at. Supports single date (YYYY-MM-DD) or date range (YYYY-MM-DD,YYYY-MM-DD).

Example:

"2025-10-05"

filter[closed_at]
string

Filter by closed at. Supports single date (YYYY-MM-DD) or date range (YYYY-MM-DD,YYYY-MM-DD).

Example:

"2019-08-14,2025-12-31"

sort
enum<string>
default:-updated_at

Sort by field. Prefix with - for descending order.

Available options:
id,
-id,
created_at,
-created_at,
updated_at,
-updated_at,
closed_at,
-closed_at
Example:

"-updated_at"

per_page
integer
default:15

Items per page (max 50)

Required range: 1 <= x <= 50

Response

A paginated list of order dispute cases

data
object[]
meta
object