---
title: "Get Disputes"
method: GET
path: "/v1/shops/{shopId}/disputes"
tags: ["Disputes"]
---

# Get Disputes

`GET /v1/shops/{shopId}/disputes`

## Request

- Base URL: `https://api.sellauth.com`
- URL: `https://api.sellauth.com/v1/shops/{shopId}/disputes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/sellauth/apis/sellauth-api/docs/v1/shops/:shopId/disputes/get.ts> (a function with typed inputs; its response is checked against the schema)

Lists the shop's payment disputes. Requires the Scale plan.

## Request body

- object
  - `page` integer, nullable: Page number.
  - `perPage` integer, nullable: Items per page, 1-100. Must be at least 1. Must not be greater than 100.
  - `statuses` string[]
  - `reasons` string[]: Must not be greater than 40 characters.
  - `gateways` string[]: Must not be greater than 50 characters.
  - `due` '24h' | '72h' | '7d', nullable: Only disputes needing a response within 24h, 72h or 7d.
  - `search` string, nullable: Buyer email, invoice ID or dispute ID. Must not be greater than 191 characters.
  - `opened_at_start` string, nullable: Must be a valid date.
  - `opened_at_end` string, nullable: Must be a valid date. Must be a date after <code>opened_at_start</code>.
  - `closed_at_start` string, nullable: Must be a valid date.
  - `closed_at_end` string, nullable: Must be a valid date. Must be a date after <code>closed_at_start</code>.
  - `orderColumn` 'id' | 'opened_at' | 'evidence_due_at' | 'amount_usd', nullable
  - `orderDirection` 'asc' | 'desc', nullable
  - `warnings` boolean, nullable: List Stripe early fraud warnings instead of disputes.

## Response `200`

- object
  - `current_page` integer
  - `data` object[]
    - `id` integer
    - `shop_id` integer
    - `invoice_id` integer
    - `payment_id` string, nullable
    - `payment_method_id` string, nullable
    - `gateway` string
    - `gateway_dispute_id` string
    - `gateway_payment_ref` string
    - `stage` string
    - `status` string
    - `is_final` boolean
    - `funds_status` string
    - `reason` string
    - `contestable` boolean
    - `gateway_status` string
    - `gateway_substatus` string, nullable
    - `gateway_reason` string
    - `network_reason_code` string
    - `card_brand` string
    - `amount` string
    - `currency` string
    - `amount_usd` string
    - `fee` string
    - `fee_currency` string
    - `fee_usd` string
    - `is_partial` boolean
    - `evidence_due_at` string
    - `opened_at` string
    - `responded_at` string, nullable
    - `closed_at` string, nullable
    - `gateway_updated_at` string
    - `gateway_version` string, nullable
    - `fetched` boolean
    - `invoice_status_before` string, nullable
    - `invoice_flipped_at` string, nullable
    - `livemode` boolean
    - `created_at` string
    - `updated_at` string
    - `invoice` object
      - `id` integer
      - `salt` string
      - `email` string
      - `price` string
      - `currency` string
      - `status` string
      - `gateway` string
      - `unique_id` string
  - `first_page_url` string
  - `from` integer
  - `last_page` integer
  - `last_page_url` string
  - `links` object[]
    - `url` string, nullable
    - `label` string
    - `page` string, nullable
    - `active` boolean
  - `next_page_url` string, nullable
  - `path` string
  - `per_page` integer
  - `prev_page_url` string, nullable
  - `to` integer
  - `total` integer

## Changes

- **2026-11-02** `ff0d59c98d7a`: 12 breaking, 21 info
  - request property `statuses/items/` was restricted to a list of enum values
  - the response property `data/items/closed_at` became nullable for the status `200`
  - the response property `data/items/gateway_substatus` became nullable for the status `200`
  - the response property `data/items/gateway_version` became nullable for the status `200`
  - …29 more
- **2026-10-13** `5cbdf10d05ab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/disputes/get.md)

---

[API](https://skmtc.dev/sellauth/apis/sellauth-api.md) - [All operations](https://skmtc.dev/sellauth/apis/sellauth-api/llms.txt) - [OpenAPI document](https://skmtc.dev/sellauth/apis/sellauth-api/revisions/ff0d59c98d7a?raw)