Disputes

PayPal merchants, partners, and external developers can use the PayPal Disputes API to manage disputes.

Table Specific Information

This view returns a list of disputes for the authenticated user.

The following filters are supported by the PayPal API:

The CreateTime filter supports the >, >=, <, <=, and = operators, while the other filters only support the = operator.

The add-in processes other filters client side within the add-in.

For example, the following queries are processed server side.

The following query retrieves details for a specific dispute:
```
SELECT * FROM Disputes WHERE DisputeId = 'PP-D-12345'
```
The following query returns details for Dispute records created after the specified date:
```
SELECT * FROM Disputes WHERE CreateTime > '2016-01-01'
```


Name	Type	References	Description
DisputeId [KEY]	String		The ID of the dispute.
CreatedTime	Datetime		The date and time when the dispute was created.
UpdatedTime	Datetime		The date and time when the dispute was updated.
Status	String		The status of the dispute. The allowed values are OPEN, WAITING_FOR_BUYER_RESPONSE, WAITING_FOR_SELLER_RESPONSE, UNDER_REVIEW, RESOLVED, OTHER.
Reason	String		The reason for the item-level dispute. The allowed values are MERCHANDISE_OR_SERVICE_NOT_RECEIVED, MERCHANDISE_OR_SERVICE_NOT_AS_DESCRIBED, UNAUTHORISED, CREDIT_NOT_PROCESSED, DUPLICATE_TRANSACTION, INCORRECT_AMOUNT, PAYMENT_BY_OTHER_MEANS, CANCELED_RECURRING_BILLING, PROBLEM_WITH_REMITTANCE, OTHER.
DisputeState	String		The state of the dispute. The allowed values are OPEN_INQUIRIES, REQUIRED_ACTION, REQUIRED_OTHER_PARTY_ACTION, UNDER_PAYPAL_REVIEW, APPEALABLE, RESOLVED.
DisputeCurrencyCode	String		The three-character ISO-4217 currency code that identifies the currency.
DisputeAmountValue	Decimal		The value of the amount.