Optimization Protection

Retrieve disputes status

You can request the status for a list of disputes by sending a POST request to the /disputes/status-query endpoint.

Note

Each page returns a maximum of 5,000 records.
The API defaults to a pageSize of 1,000 records when you do not specify a pageSize.

For pre-arbitration availability, refer to pre-arbitration availability.

Important request fields

Important required request fields
Request field name	Description	Required	Location
`request-id`	Unique request identifier provided in the header by the requestor.	Y	Header
`platform-id`	Use this ID to identify the platform sending the API request.	N	Header
`statusInquiryParameters`	Any of: list of `companyIds` list of `merchantIds` list of `disputeIds` status update date `startDateTime` (In YYYY-MM-DDTHH:MM:SSZ format) status update date `endDateTime` (In YYYY-MM-DDTHH:MM :SSZ format)	Y	Body
`pageSize`	Maximum number of records that are returned as the output for the requested page in the paginated response.	N	Body
`cursor`	Indicates the starting point for the next set of data on the paginated response. When you make a request to the API and receive a response with a next page cursor, you can use that cursor in a subsequent request to retrieve the next page of results.	N	Body

Important response fields

Important disputesStatusList response fields
Response field name	Description
`disputeStatus`	The label for the case's current stage in the dispute resolution process. Valid status values depend on the dispute type. Refer to the specific dispute type page for supported statuses and lifecycle transitions.
`outcome`	The outcome of a dispute. For chargebacks, this indicates your financial outcome after the dispute is resolved. For retrieval requests, this indicates whether the request was fulfilled. For pre-arbitration, this indicates whether liability was accepted or contested. Refer to the specific dispute type page for supported outcome values.
`financialAdjustmentIndicator`	Indicates that a recent activity or status change financially impacts your funded amount. Examples include a new dispute, a reversed chargeback, a lost dispute, or excess funds credited or debited to your account.

HTTP method: POST

Endpoint: /disputes/status-query

Scenario: Obtain the status for a list of disputes.

Json

{
  "statusInquiryParameters": {
    "merchantIds": [
      "997241028650"
    ],
    "disputeIds": [],
    "startDateTime": "2025-01-01T00:00:00Z",
    "endDateTime": "2025-09-09T12:00:00Z"
  },
  "pagination": {
    "cursor": "",
    "pageSize": 3
  }
}

Response:

Json

{
  "requestId": "7e9f510f-46f9-45d1-bff9-9db57e55c812",
  "disputesStatusList": [
    {
      "disputeId": 83017,
      "disputeStatus": "EXPIRED",
      "statusUpdateTimestamp": "2025-09-08T07:00:23.032839Z",
      "outcome": "NOT_FULFILLED",
      "financialAdjustmentIndicator": false,
      "isReversed": false,
      "relatedFinancialItems": []
    },
    {
      "disputeId": 83016,
      "disputeStatus": "EXPIRED",
      "statusUpdateTimestamp": "2025-09-08T07:00:23.023041Z",
      "outcome": "NOT_FULFILLED",
      "financialAdjustmentIndicator": false,
      "isReversed": false,
      "relatedFinancialItems": []
    },
    {
      "disputeId": 83018,
      "disputeStatus": "EXPIRED",
      "statusUpdateTimestamp": "2025-09-08T07:00:23.016749Z",
      "outcome": "NOT_FULFILLED",
      "financialAdjustmentIndicator": false,
      "isReversed": false,
      "relatedFinancialItems": []
    }
  ],
  "traceId": "3bdf5042-ba5a-46e6-80eb-05b227859131",
  "pagination": {
    "cursor": "eyJjaWQiOltdLCJtaWQiOlsiOTk3MjQxMDI4NjUwIl0sInBnIjoyLCJjc2lkIjpbXSwibHQiOjMsInN1cyI6IjIwMjUtMDEtMDFUMDA6MDA6MDBaIiwic3VlIjoiMjAyNS0wOS0wOVQxMjowMDowMFoiLCJ0cGciOjI2fQ=="
  }
}