Add Required Docs



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.

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
1509-4Invalid case ID or case ID returned no results
1509-5Invalid request {message}
1509-6Error saving case
1509-13Case ID references a case that is currently locked
1509-14Invalid request message
1509-15This case is already resolved with status: {status}
1509-16This case has been submitted for processing and this action can no longer be performed.
Click Try It! to start a request and see the response here!