---
title: "List dispute statuses"
method: GET
path: "/disputes/{disputeId}/statuses"
tags: ["Settlement"]
---

# List dispute statuses

`GET /disputes/{disputeId}/statuses`

Use this method to return the status history of a dispute.  

To view the status history of a dispute, you need its disputeId. If you don't have the disputeId, use our [List Disputes](https://docs.payroc.com/api/schema/reporting/settlement/list-disputes) method to search for the dispute. 

Our gateway returns a list that contains each status change, the date it was changed, and its updated status.

## Path parameters

- `disputeId` integer, required

## Headers

- `Authorization` string, required

## Response `200`

Successful request. Returns the status history for a specific dispute.

- DisputeStatus[]
  - `disputeStatusId` integer — Unique identifier that we assigned to the status of the dispute.
  - `status` 'prearbitrationInProcess' | 'prearbitrationAccepted' | 'prearbitrationDeclined' | 'arbitrationFiledWithCardBand' | 'arbitrationFundsToBeReturned' | 'arbitrationLost' | 'arbitrationSettledPartialAmount' | 'precomplianceInProcess' | 'precomplianceAccepted' | 'precomplianceDeclined' | 'complianceFiledWithCardBand' | 'complianceLost' | 'complianceSettledPartialAmount' | 'invalid' | 'issuerReversal' | 'new' | 'rejected' | 'representmentInProgress' | 'representmentFailed' | 'representmentPaid' | 'representmentReceived' | 'stand' — Status of the dispute. **Note:** If you want to view the status history of the dispute, use our [List Dispute Statuses](https://docs.payroc.com/api/schema/reporting/settlement/list-disputes-statuses) method.
  - `statusDate` string, date — Date that the status of the dispute was last changed. The format of this value is **YYYY-MM-DD**.

## Other responses

- `400` — Validation error
- `401` — Identity could not be verified
- `403` — Do not have permissions to perform this action
- `404` — Resource not found
- `406` — Not acceptable
- `500` — An error has occured

---

[API](https://skmtc.dev/payroc/apis/schema.md) · [All operations](https://skmtc.dev/payroc/apis/schema/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/payroc/schema/revisions/1d9d3e305945/schema)