# Disputes

A dispute is created when a customer questions your charge with their bank or the credit card company. When this happens, you have an opportunity to respond by providing evidence that the charge is legitimate.

 - [GET /disputes](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/disputes/listdisputes.md): Lists dispute objects. Results are sorted by creation date, with the most recent objects first.
 - [GET /disputes/{disputeId}](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/disputes/getdispute.md): Retrieves an existing dispute object.
 - [POST /disputes/{disputeId}](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/disputes/updatedispute.md): Updates an existing dispute object. Any parameters not provided are left unchanged.
 - [POST /disputes/{disputeId}/close](https://matterhorn-api.redocly.app/docs/api/shift4-gateway/disputes/closedispute.md): Closing the dispute indicates that you do not want to submit any further evidence and acknowledge it as lost.
