---
title: "List Settlement Disputes for a Partner"
method: GET
path: "/api/network/v1/enterprises/{enterpriseId}/partners/settlement/disputes"
tags: ["Settlement Disputes"]
---

# List Settlement Disputes for a Partner

`GET /api/network/v1/enterprises/{enterpriseId}/partners/settlement/disputes`

This API call allows partners to list disputes associated with their settlements.

**Requires access token scope:** `settlement_network_read`

## Path parameters

- `enterpriseId` string, required

## Query parameters

- `settlementIds` string[]
- `settledInSettlementIds` string[]
- `connectionIds` string[]
- `partnerIds` string[]
- `closed` boolean
- `disputeIds` string[]
- `disputeClosureIds` string[]
- `pageNumber` string, integer
- `pageSize` string
- `settlementExternalIds` string[]
- `settledInSettlementExternalIds` string[]
- `showRetracted` boolean
- `clientIds` string[]

## Response `200`

OK

- V1DisputesWithClosureWithTransfersOutput
  - `disputes` object[], required
    - `disputeClosure` DisputeClosureOutput
      - `id` string, required — The unique identifier of the dispute closure.
      - `closedBy` 'client' | 'admin', required
      - `userId` string, required — The id of the user who closed the dispute.
      - `notes` string, required — notes entered by the user when closing the dispute.
      - `adjustedSettlementTransfers` object[], required
        - `id` string, required — The unique identifier of the settlement transfer.
        - `sourceTradingAccountId` string, required — The go account id of the source party.
        - `destinationTradingAccountId` string, required — The go account id of the destination party.
        - `destinationNetworkAccountId` string, required — The network account id of the destination party.
        - `disputeClosureId` string, required — The unique identifier of the dispute closure the settlement transfer was created from. This is a UUID that uniquely identifies dispute closure if the transfer was created as a result of closing a dispute.
        - `currency` string, required — The currency involved in the settlement movement.
        - `quantity` string, required
        - `status` 'pending' | 'pending_onchain' | 'onchain_initiated' | 'onchain_failed' | 'completed' | 'failed' | 'rejected' | 'disputed' | 'pending_settlement_assignment', required
        - `createdAt` string, date-time, required — The date and time when the settlement transfer was created. Represented as an ISO 8601 formatted date string.
        - `updatedAt` string, date-time, required — The date and time when the settlement transfer was last updated. Represented as an ISO 8601 formatted date string.
        - `settlementId` string — The unique identifier of the settlement the settlement transfer is associated with. This is a UUID that uniquely identifies the settlement. Will only be undefined if the settlement transfer is in `pending_settlement_assignment` status.
        - `sourceNetworkAccountId` string — The network account id of the source party.
      - `createdAt` string, date-time, required — The date and time when the dispute closure was created.
      - `status` 'pending_review' | 'approved' | 'rejected', required
      - `adjustedTransfers` ExpectedTransfers, required
      - `reviewedBy` string — The id of the admin who reviewed the dispute closure.
      - `reviewNotes` string — Any comments entered by the admin when reviewing the dispute closure.
    - `id` string, required
    - `createdAt` string, date-time, required
    - `updatedAt` string, date-time, required
    - `connectionId` string, required
    - `disputedSettlementId` string, required
    - `userId` string, required
    - `expectedTransfers` ExpectedTransfersOutput, required
    - `retracted` boolean, required
    - `settledInSettlementId` string
    - `reason` string
    - `retractedBy` string
    - `retractedAt` string, date-time
    - `disputeClosureId` string
    - `retractedReason` string

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `409` — Conflict
- `422` — Unprocessable Entity
- `500` — Internal Server Error

---

[API](https://skmtc.net/bitgo/apis/bitgo-api.md) · [All operations](https://skmtc.net/bitgo/apis/bitgo-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/bitgo/bitgo-api/revisions/e445c15e5bee/schema)