Availability
The Dispute API is under development and will be generally available in 2025.
Use the Get Case Reasons endpoint to retrieve the case reasons, which are questions and answers that you display to the account holder during the creation of a dispute case. The answers to these questions classify the type of dispute and provide a reason for the dispute. The case reasons are radio buttons so that the account holder can select only one option.
This endpoint is part of a conversational API—a series of endpoint calls that must be made in a certain order. For instructions see the Creating a Dispute guide.
- Previous endpoint: Create Case
- Next endpoint: Add Case Reasons
Status codes
See Global Response Statuses for status codes that are common across endpoints.
The table below lists status codes that apply to this specific endpoint.
| Status code | Description |
|---|---|
| 1503-4 | Invalid case ID or case ID returned no results |
| 1503-5 | Invalid request {message} |
| 1503-6 | Error saving case |
| 1503-13 | Case ID references a case that is currently locked |
| 1503-14 | Invalid request message |
| 1503-15 | This case is already resolved with status |
| 1503-16 | This case has been submitted for processing and this action can no longer be performed |