List disputes

Returns a list of disputes filed against the store’s payments. Requires the DISPUTES_READ scope.

GET https://api.pandabase.io/v2/core/stores/{storeId}/disputes/

Authentication

Requires a bearer token (sk_…) or an API key in the header Authorization.

Path parameters

storeId string required

(length 12–48)

Query parameters

page integer default: 1

(range 1–∞, defaults to 1)

limit integer default: 25

(range 1–100, defaults to 25)

status enum

No description.

sort enum

No description.

needsEvidence boolean

No description.

Header parameters

idempotency-key string

(length 8–32)

Response 200

Default Response

ok enum required

(one of true)

data object required

No description.

Response 400

Default Response

ok enum required

(one of false)

error string required

No description.

Request
curl -X GET https://api.pandabase.io/v2/core/stores/:storeId/disputes/
Response
{  "ok": true,  "data": {    "items": [      {        "id": "dsp_8h0r1n4tzcbfp2v8q1mzwxj5",        "reason": "FRAUDULENT",        "status": "AWAITING_REVIEW",        "evidence": null,        "totalAmount": 2920,        "amount": 2900,        "fee": 2000,        "createdAt": "2026-05-14T09:12:00.000Z",        "order": {          "id": "ord_p2v8q1mzj0kxw5h7n4tr3bcf",          "orderNumber": "cs_abcdef0123456789",          "status": "CHARGEBACK",          "customer": {            "id": "cus_j8h0r1n4tzcbfp2v8q1mzwx5",            "email": "buyer@example.com"          }        }      }    ],    "pagination": {      "page": 1,      "limit": 25,      "total": 1,      "totalPages": 1    }  }}