Create Case



The Dispute API is under development and will be generally available in 2025.

Use the Create Case endpoint to initiate a dispute claim. A single claim may contain multiple disputed transactions. Call this endpoint when the account holder initiates a claim by clicking a "dispute a transaction" control on your interface.

This endpoint returns a case number (caseId) that you pass with all subsequent endpoint calls that are related to this dispute.

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.

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 codeDescription
1502-1Invalid customer ID
1502-2Invalid case ID or case ID returned no results
1502-3Error creating case
1502-5Invalid request {message}
1502-13Case ID references a case that is currently locked
1502-14Invalid request message
Click Try It! to start a request and see the response here!