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 server processes other filters client-side within the server.

The following queries are processed server-side.

Retrieve details for a specific dispute:

SELECT * FROM Disputes WHERE DisputeId = 'PP-D-12345'

Retrieve 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.
DisputeLifecycleStage	String		The stage in the dispute lifecycle.
DisputeChannel	String		The channel where the customer created the dispute.
BuyerResponseDueDate	Datetime		The date and time by when the customer must respond to the dispute.
SellerResponseDueDate	Datetime		The date and time by when the seller must respond to the dispute.