---
title: "List Dispute Documents"
method: GET
path: "/disputes/{disputeKey}/documents"
tags: ["Disputes"]
---

# List Dispute Documents

`GET /disputes/{disputeKey}/documents`

## Request

- Base URL: `https://eu-west-1.api.silverflow.com/v1`
- URL: `https://eu-west-1.api.silverflow.com/v1/disputes/{disputeKey}/documents`
- Auth: one of:
  - HTTP basic
  - HTTP bearer
- TypeScript: <https://skmtc.dev/silverflow/apis/silverflow-api/docs/disputes/:disputeKey/documents/get.ts> (a function with typed inputs; its response is checked against the schema)

This operation returns a (paged) list of (active) Documents (metadata) for a Dispute.

Requires `disputes:ListDocuments` permission.

## Path parameters

- `disputeKey` string, required: Uniquely identifies a Dispute.

## Query parameters

- `sortOrder` 'asc' | 'desc'
- `limit` integer
- `offsetToken` string
- `owner` 'issuer' | 'acquirer' | 'merchant' | 'card-network'
- `status` 'pending' | 'active' | 'archived'

## Response `200`

A (paged) list of Documents (metadata)

- DisputeDocumentsPage
  - `moreItems` boolean
  - `offsetToken` string
  - `documents` DisputeDocument[], required
    - `key` string, required: Uniquely identifies a document
    - `agentKey` string, required: Uniquely identifies an Agent
    - `merchantKey` string: Uniquely identifies a Merchant
    - `disputeKey` string, required: Uniquely identifies a Dispute.
    - `disputeStage` 'rapidDisputeResolution' | 'collaboration' | 'requestForInformation' | 'requestForInformationResponse' | 'collaborationResponse' | 'chargeback' | 'chargebackResponse' | 'preArbitration' | 'preArbitrationResponse' | 'arbitration', required: The current stage of a Dispute
    - `originalFilename` string, required: Name of the file. Allows letters, numbers, whitespaces and characters _()
    - `filename` string
    - `contentLength` number
    - `contentType` 'image/jpeg' | 'application/pdf' | 'image/tiff': Accepted Content-Types
    - `owner` 'issuer' | 'acquirer' | 'merchant' | 'card-network', required: The owner of a Dispute Document
    - `description` string
    - `status` 'pending' | 'active' | 'archived', required: The current status of the document.
    - `created` string, date-time, required: The date and time this object was created
    - `lastModified` string, date-time: The date and time this object was last modified
    - `version` integer, required: The version of this object

## Other responses

- `401`: Authentication information is missing or invalid
- `403`: The authenticated client is forbidden to make the request for the resource identified.
- `404`: The requested resource was not found
- `429`: The number of requests (per minute) has exceeded the configured maximum

---

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