---
title: Disputes v1
canonical: https://developer.paypal.com/api/customer-disputes/v1
openapi_schema:
  json: https://developer.paypal.com/api/customer-disputes/v1/schema.json
  yaml: https://developer.paypal.com/api/customer-disputes/v1/schema.yaml
---

# Disputes v1 (/api/customer-disputes/v1)

> This is an API reference page. The information below is a summary — the [JSON](https://developer.paypal.com/api/customer-disputes/v1/schema.json) and [YAML](https://developer.paypal.com/api/customer-disputes/v1/schema.yaml) schema are the preferred, authoritative source for exact parameters, request/response shapes, and validation rules.

## Base URL(s)

- https://api-m.sandbox.paypal.com

## Authentication

- Oauth2 (OAuth 2.0, clientCredentials)

## Operations

### disputes

- `GET` [List disputes](/api/customer-disputes/v1/disputes-list): Lists disputes with a summary set of details, which shows the dispute_id , reason , status , dispute_state , dispute_life_cycle_stage ,…
- `GET` [Show dispute details](/api/customer-disputes/v1/disputes-get): Shows details for a dispute, by ID.
- `PATCH` [Partially update dispute](/api/customer-disputes/v1/disputes-patch): Partially updates a dispute, by ID.

### disputes-actions

- `POST` [Provide evidence](/api/customer-disputes/v1/disputes-provide-evidence): Provides evidence for a dispute, by ID.
- `POST` [Appeal dispute](/api/customer-disputes/v1/disputes-appeal): Appeals a dispute, by ID.
- `POST` [Accept claim](/api/customer-disputes/v1/disputes-accept-claim): Accepts liability for a claim, by ID.
- `POST` [Settle dispute](/api/customer-disputes/v1/disputes-adjudicate): Important: This method is for sandbox use only.
- `POST` [Update dispute status](/api/customer-disputes/v1/disputes-require-evidence): Important: This method is for sandbox use only.
- `POST` [Escalate dispute to claim](/api/customer-disputes/v1/disputes-escalate): Escalates the dispute, by ID, to a PayPal claim.
- `POST` [Send message about dispute to other party](/api/customer-disputes/v1/disputes-send-message): Sends a message about a dispute, by ID, to the other party in the dispute.
- `POST` [Make offer to resolve dispute](/api/customer-disputes/v1/disputes-make-offer): Makes an offer to the other party to resolve a dispute, by ID.
- `POST` [Accept offer to resolve dispute](/api/customer-disputes/v1/disputes-accept-offer): The customer accepts the offer from merchant to resolve a dispute, by ID.
- `POST` [Deny offer to resolve dispute](/api/customer-disputes/v1/disputes-deny-offer): Denies an offer that the merchant proposes for a dispute, by ID.
- `POST` [Acknowledge returned item](/api/customer-disputes/v1/disputes-acknowledge-return-item): Acknowledges that the customer returned an item for a dispute, by ID.
- `POST` [Provide supporting information for dispute](/api/customer-disputes/v1/disputes-provide-supporting-info): Provides supporting information for a dispute, by ID.

## Full schema

The list above is a summary. Full parameter, request, and response detail for every operation lives in the schema: [JSON](https://developer.paypal.com/api/customer-disputes/v1/schema.json) · [YAML](https://developer.paypal.com/api/customer-disputes/v1/schema.yaml)