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

# Get Dispute

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

## Request

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

Retrieves one payment dispute with its timeline. Requires the Scale plan.

## Response `200`

- object
  - `dispute` 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
      - `shop_id` integer
      - `email` string
      - `price` string
      - `currency` string
      - `status` string
      - `gateway` string
      - `ip` string
      - `country_code` string, nullable
      - `created_at` string
      - `completed_at` string
      - `unique_id` string
    - `payment_method` string, nullable
  - `timeline` object[]
    - `id` integer
    - `type` string
    - `actor` string
    - `data` object
      - `stage` string
      - `amount` string
      - `reason` string
      - `status` string
      - `gateway` string
      - `currency` string
      - `dispute_id` integer
      - `evidence_due_at` string
    - `created_at` string
  - `actions` object
    - `cashback_usd` integer
    - `affiliate_commission_usd` integer
    - `is_topup` boolean
    - `can_reclassify` boolean
    - `buyer` object
      - `email` string
      - `ip` string
    - `blacklisted` object
      - `email` boolean
      - `ip` boolean
    - `subscription` string, nullable

## Changes

- **2026-11-02** `ff0d59c98d7a`: 11 breaking
  - the response property `actions/subscription` became nullable for the status `200`
  - the response property `dispute/closed_at` became nullable for the status `200`
  - the response property `dispute/gateway_substatus` became nullable for the status `200`
  - the response property `dispute/gateway_version` became nullable for the status `200`
  - …7 more
- **2026-10-13** `5cbdf10d05ab`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/sellauth/apis/sellauth-api/changes/v1/shops/:shopId/disputes/:disputeId/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/156a9aef5e98?raw)