Availability
The Dispute API is under development and will be generally available in 2025.
Use the Add Required Docs endpoint to submit the PDF form that the account holder filled out, if a form was returned by Get Doc Requirements.
This endpoint is part of a conversational API—a series of endpoint calls that must be made in a certain order. If you call this endpoint, it must be during the intake flow; you cannot call it after the case has been submitted.
To attach multiple documents with this endpoint, call the endpoint once for each document. If you need to attach documents after the case has been submitted, use the Add Documents endpoint.
For instructions see the Creating a Dispute guide.
- Previous endpoint: Get Doc Requirements
- Next endpoint: Optional. Get Case Summary
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 |
|---|---|
| 1509-4 | Invalid case ID or case ID returned no results |
| 1509-5 | Invalid request {message} |
| 1509-6 | Error saving case |
| 1509-13 | Case ID references a case that is currently locked |
| 1509-14 | Invalid request message |
| 1509-15 | This case is already resolved with status: {status} |
| 1509-16 | This case has been submitted for processing and this action can no longer be performed. |