# Dispute Responses

## Submit Dispute Case Response

> Submit a response for a specific dispute case, with optional text comments and supporting evidence files.

```json
{"openapi":"3.0.1","info":{"title":"Dispute.API","version":"0.0.1"},"paths":{"/api/disputes/v2.0/responses":{"post":{"tags":["Dispute Responses"],"summary":"Submit Dispute Case Response","description":"Submit a response for a specific dispute case, with optional text comments and supporting evidence files.","operationId":"SubmitDisputeResponse","requestBody":{"content":{"application/json":{"schema":{"type":"object","properties":{"ResponseType":{"type":"integer","description":"Indicates whether the merchant’s response is accepted or declined. Example: 1 for Accepted, 2 for Declined.","format":"int32"},"CaseNumber":{"type":"string","description":"The unique dispute case identification number eligible for Chargeback or Retrieval cases. The dispute case must be Awaiting Response or New Activity."},"Response":{"type":"string","description":"The message provided by the merchant for the dispute case. Free text up to 500 characters."},"evidences":{"type":"array","items":{"type":"string","format":"binary"},"description":"One or more evidence files included with the dispute case response."}}},"encoding":{"ResponseType":{"style":"form"},"CaseNumber":{"style":"form"},"Response":{"style":"form"},"evidences":{"style":"form"}}}}},"responses":{"202":{"description":"Accepted","content":{"application/json":{"schema":{"$ref":"#/components/schemas/UploadEventResponse"}}}},"204":{"description":"No Content"},"400":{"description":"Bad Request","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XErrorResponse"}}}},"401":{"description":"Unauthorized","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XErrorResults"}}}},"403":{"description":"Forbidden","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XErrorResults"}}}},"406":{"description":"Not Acceptable","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XErrorResponse"}}}},"500":{"description":"Server Error","content":{"application/json":{"schema":{"$ref":"#/components/schemas/XErrorResponse"}}}}}}}},"components":{"schemas":{"UploadEventResponse":{"type":"object","properties":{"attachments":{"type":"array","items":{"$ref":"#/components/schemas/Attachment"},"description":"List of uploaded evidence file details.","nullable":true},"responseId":{"type":"integer","description":"Unique identifier for the submitted merchant response.","format":"int32"},"responseMessage":{"type":"string","description":"A message confirming the status of the submitted response.","nullable":true},"caseNumber":{"type":"string","description":"Unique dispute case identification number associated with the submitted response.","nullable":true},"exchangeId":{"type":"string","description":"Identifier used to track the exchange of information with the dispute processing system.","nullable":true},"correlationId":{"type":"string","description":"Unique identifier used for tracking the request across systems.","nullable":true},"parentId":{"type":"string","description":"Identifier that links the response to a parent transaction or message.","nullable":true},"parentSystemCode":{"type":"string","description":"System code for the upstream system that originated the request.","nullable":true},"merchantNumber":{"type":"string","description":"The merchant's unique identification number.","nullable":true}},"additionalProperties":false,"description":"Response containing upload event details for a submitted dispute case response."},"Attachment":{"type":"object","properties":{"merchantNumber":{"type":"string","description":"The merchant's unique identification number associated with the attachment.","nullable":true},"attachmentId":{"type":"integer","description":"Unique identifier for the evidence attachment.","format":"int32"},"fileName":{"type":"string","description":"The name of the uploaded evidence file.","nullable":true},"filePath":{"type":"string","description":"The storage location or path of the uploaded file.","nullable":true},"uploadedDateTime":{"type":"string","description":"The date and time when the evidence file was uploaded. Format: YYYY-MM-DDThh:mm:ss.sssZ.","nullable":true}},"additionalProperties":false},"XErrorResponse":{"type":"object","properties":{"errorResults":{"type":"array","items":{"$ref":"#/components/schemas/XErrorResult"},"description":"Contains one or more error objects returned.","nullable":true}},"additionalProperties":false},"XErrorResult":{"type":"object","properties":{"errorMessage":{"type":"string","description":"Describes the reason for the error.","nullable":true},"resultCode":{"type":"integer","description":"Numeric code that identifies the type of error returned by the request.","format":"int32"},"timeStamp":{"type":"string","description":"Date and time when the error occurred, ISO 8601 format (UTC).","format":"date-time"}},"additionalProperties":false},"XErrorResults":{"type":"object","properties":{"type":{"type":"string","description":"A URI reference that identifies the problem type.","nullable":true},"title":{"type":"string","description":"A short, human-readable summary of the problem.","nullable":true},"status":{"type":"integer","description":"The HTTP status code for this error.","format":"int32"},"detail":{"type":"string","description":"A human-readable explanation specific to this occurrence of the problem.","nullable":true},"instance":{"type":"string","description":"A URI reference that identifies the specific occurrence of the problem.","nullable":true},"otherProperties":{"type":"object","additionalProperties":{},"description":"Any additional error details returned by the API.","nullable":true}},"additionalProperties":false,"description":"Contains one or more error objects returned."}}}}
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.xplorpay.com/api-reference/api/disputes/disputes-management/dispute-responses.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.