dispute_info_list

An array of disputes that match the filter criteria. Sorted in latest to earliest creation time order.

An array of dispute_info objects.

reasonenum<dispute_reason>Optional

The reason for the item-level dispute. For information about the required information for each dispute reason and associated evidence type, see dispute reasons.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"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"

statusenum<status>Optional

The overall status of the dispute, constant for all the parties involved at anytime during the dispute lifecycle.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"OPEN"
"WAITING_FOR_BUYER_RESPONSE"
"WAITING_FOR_SELLER_RESPONSE"
"UNDER_REVIEW"
"RESOLVED"
"OTHER"

dispute_stateenum<dispute_state>Optional

The user specific state of the dispute, could vary between parties during the dispute lifecycle.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"OPEN_INQUIRIES"
"REQUIRED_ACTION"
"REQUIRED_OTHER_PARTY_ACTION"
"UNDER_PAYPAL_REVIEW"
"APPEALABLE"
"RESOLVED"

dispute_amountobject<money>Optional

The amount in the transaction that the customer originally disputed. Because customers can sometimes dispute only part of the payment, the disputed amount might be different from the total gross or net amount of the original transaction.

dispute_life_cycle_stageenum<dispute_lifecycle_stage>Optional

The stage in the dispute lifecycle.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"INQUIRY"
"CHARGEBACK"
"PRE_ARBITRATION"
"ARBITRATION"

buyer_response_due_datestring<date_time>Optional

The date and time by when the customer must respond to the dispute, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). If the customer does not respond by this date and time, the dispute is closed in the merchant's favor. For example, *`yyyy`*-*`MM`*-*`dd`*`T`*`HH`*:*`mm`*:*`ss`*.*`SSS`*`Z`.

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$Formatppaas_date_time_v3Length20 <= length <= 64

seller_response_due_datestring<date_time>Optional

The date and time by when the merchant must respond to the dispute, in [Internet date and time format](https://tools.ietf.org/html/rfc3339#section-5.6). If the merchant does not respond by this date and time, the dispute is closed in the customer's favor. For example, *`yyyy`*-*`MM`*-*`dd`*`T`*`HH`*:*`mm`*:*`ss`*.*`SSS`*`Z`.

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$Formatppaas_date_time_v3Length20 <= length <= 64

An array of disputes that match the filter criteria. Sorted in latest to earliest creation time order.

An array of dispute_info objects.

reasonenum<dispute_reason>Optional

The reason for the item-level dispute. For information about the required information for each dispute reason and associated evidence type, see dispute reasons.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"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"

statusenum<status>Optional

The overall status of the dispute, constant for all the parties involved at anytime during the dispute lifecycle.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"OPEN"
"WAITING_FOR_BUYER_RESPONSE"
"WAITING_FOR_SELLER_RESPONSE"
"UNDER_REVIEW"
"RESOLVED"
"OTHER"

dispute_stateenum<dispute_state>Optional

The user specific state of the dispute, could vary between parties during the dispute lifecycle.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"OPEN_INQUIRIES"
"REQUIRED_ACTION"
"REQUIRED_OTHER_PARTY_ACTION"
"UNDER_PAYPAL_REVIEW"
"APPEALABLE"
"RESOLVED"

dispute_amountobject<money>Optional

dispute_life_cycle_stageenum<dispute_lifecycle_stage>Optional

The stage in the dispute lifecycle.

Match^[0-9A-Z_]+$Length1 <= length <= 255

Allowed values

"INQUIRY"
"CHARGEBACK"
"PRE_ARBITRATION"
"ARBITRATION"

buyer_response_due_datestring<date_time>Optional

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$Formatppaas_date_time_v3Length20 <= length <= 64

seller_response_due_datestring<date_time>Optional

Match^[0-9]{4}-(0[1-9]|1[0-2])-(0[1-9]|[1-2][0-9]|3[0-1])[T,t]([0-1][0-9]|2[0-3]):[0-5][0-9]:([0-5][0-9]|60)([.][0-9]+)?([Zz]|[+-][0-9]{2}:[0-9]{2})$Formatppaas_date_time_v3Length20 <= length <= 64

dispute_info_list

money properties

cryptocurrency properties

link_description properties

link_schema properties

media properties

link_schema properties

media properties

Back to top

On this page

On this page

dispute_info_list

money properties

cryptocurrency properties

link_description properties

link_schema properties

media properties

link_schema properties

media properties

Back to top

On this page

dispute_info_list

money properties

cryptocurrency properties

link_description properties

link_schema properties

media properties

link_schema properties

media properties

Back to top

On this page

On this page

If you accept cookies, we’ll use them to improve and customize your experience and enable our partners to show you personalized PayPal ads when you visit other sites. Manage cookies and learn more

dispute_info_list

money properties

cryptocurrency properties

link_description properties

link_schema properties

media properties

link_schema properties

media properties

Back to top

On this page