Dispute
Dispute: Search
Returns a collection of Dispute response objects.
For operators available on search fields, see the search fields page.
- Python
search_results = gateway.dispute.search([
braintree.DisputeSearch.id == "dispute_id"
])
for dispute in search_results.disputes.items:
print dispute.id
Parameters
'amount_disputed'
range'amount_won'
range'case_number'
text'chargeback_protection_level'
multipleThe chargeback protection level of the dispute. Possible values:
- EFFORTLESS
- STANDARD
- NOT_PROTECTED
'customer_id'
text'disbursement_date'
range'effective_date'
range'id'
text'kind'
multiple'merchant_account_id'
multipleA fragment of the merchant account ID to search for.
'contains'
text'ends_with'
text'is'
text'is_not'
text'starts_with'
text'pre_dispute_program'
multipleThe pre-dispute program of the dispute. Possible values:
- VISA_RDR
- NONE
'reason'
multipleThe reason for the dispute. See reasons on the dispute response object for possible values.
'reason_code'
multiple'received_date'
range'reply_by_date'
range'status'
multipleThe status of the dispute. Possible values:
- ACCEPTED
- AUTO_ACCEPTED
- DISPUTED
- EXPIRED
- OPEN
- LOST
- WON
See dispute statuses for more details.
'transaction_id'
text'transaction_source'
multipleHow a transaction was created. Possible values:
- API
- CONTROL_PANEL
- RECURRING
- OAuth application client ID of the transaction facilitator
Examples
Multiple kinds
This example shows searches on the kind parameter:
- Python
search_results = gateway.dispute.search([
braintree.DisputeSearch.kind.in_list([
braintree.Dispute.Kind.Chargeback,
braintree.Dispute.Kind.Retrieval
])
])
Amount disputed range
This example shows searches on the amount_disputed parameter:
- Python
search_results = gateway.dispute.search([
braintree.DisputeSearch.amount_disputed.between("100.00", "200.00")
])