# Dispute Evidence

Dispute evidence is submitted by the merchant to support the legitimacy of a
<a href="/docs/admin-api/rest/reference/shopify_payments/dispute">
  dispute
</a>.

## Resource Properties

### Dispute Evidence

* id: The ID of the dispute evidence.
  * Type: x-string
  * Example: 54534554564
* payments_dispute_id: The ID of the dispute that the dispute evidence belongs to.
  * Type: x-string
  * Example: 54534554564
* access_activity_log: The activity logs associated with the dispute evidence.
  * Type: x-string
  * Example: "Test access activity logs"
* customer_email_address: The customer's email address.
  * Type: x-string
  * Example: "kermit@shopify.com"
* customer_first_name: The customer's first name.
  * Type: x-string
  * Example: "Kermit"
* customer_last_name: The customer's last name.
  * Type: x-string
  * Example: "The Frog"
* uncategorized_text: The uncategorized text for the dispute evidence.
  * Type: x-string
  * Example: "Other compelling text for dispute"
* shipping_address: The mailing address for shipping that is provided by the customer.
  * Type: x-string
  * Example: {"address1"=>"1 Infinite Loop", "address2"=>"Muppet Studio", "city"=>"Cupertino", "zip"=>"95014", "country"=>"United States", "country_code"=>"US", "province"=>"California", "province_code"=>"CA"}
* cancellation_policy_disclosure: The cancellation policy disclosure associated with the dispute evidence.
  * Type: x-string
  * Example: "Test cancellation policy disclosure"
* cancellation_rebuttal: The cancellation rebuttal associated with the dispute evidence.
  * Type: x-string
  * Example: "Test cancellation rebuttal"
* refund_policy_disclosure: The refund policy disclosure associated with the dispute evidence.
  * Type: x-string
  * Example: "Test refund policy disclosure"
* refund_refusal_explanation: The refund refusal explanation associated with the dispute evidence.
  * Type: x-string
  * Example: "Test refund refusal explanation"
* product_description: The product description for this dispute evidence.
  * Type: x-string
  * Example: {"Product name"=>"Draft", "Title"=>"151cm", "Price"=>"$10.00", "Quantity"=>"1", "Product Description"=>"good board"}
* submitted: Whether the dispute evidence is submitted.
  * Type: x-string
  * Example: false
* created_at:           "The date and time (<a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a> format) when
          dispute evidence was created.

  * Type: x-string
  * Example: "2022-01-09T11:00:00-05:00"
* updated_on:           "The date and time (<a href="https://en.wikipedia.org/wiki/ISO_8601">ISO 8601</a> format) when
          dispute evidence was updated. Returns <code>null</code> if evidence has not yet been updated.

  * Type: x-string
  * Example: "2022-01-09T11:00:00-05:00"
* dispute_evidence_files: Dispute files associated with dispute evidence.
  * Type: x-string
  * Example: {"cancellation_policy_file_id"=>nil, "customer_communication_file_id"=>nil, "customer_signature_file_id"=>nil, "refund_policy_file_id"=>nil, "service_documentation_file_id"=>nil, "shipping_documentation_file_id"=>nil, "uncategorized_file_id"=>1}
* billing_address: The billing address that is provided by the customer.
  * Type: x-string
  * Example: {"address1"=>"1 Infinite Loop", "address2"=>"Muppet Studio", "city"=>"Cupertino", "zip"=>"95014", "country"=>"United States", "country_code"=>"US", "province"=>"California", "province_code"=>"CA"}
* fulfillments: The fulfillments associated with the dispute evidence.
  * Type: x-string
  * Example: [{"shipping_carrier"=>"FedEx", "shipping_tracking_number"=>4321, "shipping_date"=>"2017-01-02T13:00:00+00:00"}]
## Returns evidence associated with the dispute

Retrieves evidence associated with dispute ID.

### Endpoint
/admin/api/#{api_version}/shopify_payments/disputes/{dispute_id}/dispute_evidences.json (GET)

### Parameters
* api_version (required): 
* dispute_id (required): 

### Responses
#### 200
Returns evidence associated with the dispute

Examples:
##### Retrieves dispute evidence by dispute ID
Request:
```
GET /admin/api/2022-07/shopify_payments/disputes/598735659/dispute_evidences.json
```

Response:
```
HTTP/1.1 200 OK
{"dispute_evidence":{"id":819974671,"payments_dispute_id":598735659,"access_activity_log":null,"billing_address":{"id":867402159,"address1":"123 Amoebobacterieae St","address2":"","city":"Ottawa","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"K2P0V6"},"cancellation_policy_disclosure":null,"cancellation_rebuttal":null,"customer_email_address":"example@shopify.com","customer_first_name":"Kermit","customer_last_name":"the Frog","product_description":"Product name: Draft\nTitle: 151cm\nPrice: $10.00\nQuantity: 1\nProduct Description: good board","refund_policy_disclosure":null,"refund_refusal_explanation":null,"shipping_address":{"id":867402159,"address1":"123 Amoebobacterieae St","address2":"","city":"Ottawa","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"K2P0V6"},"uncategorized_text":"Sample uncategorized text","created_at":"2025-01-02T11:09:43-05:00","updated_at":"2025-01-02T11:22:43-05:00","submitted_by_merchant_on":null,"fulfillments":[{"shipping_carrier":"UPS","shipping_tracking_number":"1234","shipping_date":"2017-01-01"},{"shipping_carrier":"FedEx","shipping_tracking_number":"4321","shipping_date":"2017-01-02"}],"dispute_evidence_files":{"cancellation_policy_file_id":null,"customer_communication_file_id":539650252,"customer_signature_file_id":799719586,"refund_policy_file_id":null,"service_documentation_file_id":null,"shipping_documentation_file_id":799719586,"uncategorized_file_id":567271523}}}
```
## Updates dispute evidence

Updates dispute evidence associated with the dispute ID.

### Endpoint
/admin/api/#{api_version}/shopify_payments/disputes/{dispute_id}/dispute_evidences.json (PUT)

### Parameters
* api_version (required): 
* dispute_id (required): 

### Responses
#### 200
Updates dispute evidence

Examples:
##### Submits dispute evidence request
Request:
```
PUT /admin/api/2022-07/shopify_payments/disputes/598735659/dispute_evidences.json
{"dispute_evidence":{"submit_evidence":true}}
```

Response:
```
HTTP/1.1 200 OK
{"dispute_evidence":{"id":819974671,"payments_dispute_id":598735659,"access_activity_log":null,"billing_address":{"id":867402159,"address1":"123 Amoebobacterieae St","address2":"","city":"Ottawa","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"K2P0V6"},"cancellation_policy_disclosure":null,"cancellation_rebuttal":null,"customer_email_address":"example@shopify.com","customer_first_name":"Kermit","customer_last_name":"the Frog","product_description":"Product name: Draft\nTitle: 151cm\nPrice: $10.00\nQuantity: 1\nProduct Description: good board","refund_policy_disclosure":null,"refund_refusal_explanation":null,"shipping_address":{"id":867402159,"address1":"123 Amoebobacterieae St","address2":"","city":"Ottawa","province":"Ontario","province_code":"ON","country":"Canada","country_code":"CA","zip":"K2P0V6"},"uncategorized_text":"Sample uncategorized text","created_at":"2025-01-02T11:09:43-05:00","updated_at":"2025-01-02T11:22:42-05:00","submitted_by_merchant_on":"2025-01-02T11:22:42-05:00","fulfillments":[{"shipping_carrier":"UPS","shipping_tracking_number":"1234","shipping_date":"2017-01-01"},{"shipping_carrier":"FedEx","shipping_tracking_number":"4321","shipping_date":"2017-01-02"}],"dispute_evidence_files":{"cancellation_policy_file_id":null,"customer_communication_file_id":539650252,"customer_signature_file_id":799719586,"refund_policy_file_id":null,"service_documentation_file_id":null,"shipping_documentation_file_id":799719586,"uncategorized_file_id":567271523}}}
```
##### Update dispute evidence's information
Request:
```
PUT /admin/api/2022-07/shopify_payments/disputes/598735659/dispute_evidences.json
{"dispute_evidence":{"access_activity_log":"https://example.com/access-activity-log","cancellation_policy_disclosure":"https://example.com/cancellation-policy","cancellation_rebuttal":"https://example.com/cancellation-rebuttal","customer_email_address":"customer@example.com","customer_first_name":"John","customer_last_name":"Doe","refund_policy_disclosure":"https://example.com/refund-policy","refund_refusal_explanation":"Product must have receipt of proof of purchase","uncategorized_text":"Any additional notes","shipping_address_attributes":{"address1":"1 Infinite Loop","address2":"Muppet Studio","city":"Cupertino","zip":"95014","country_code":"US","province_code":"CA"},"fulfillments_attributes":[{"shipping_carrier":"FedEx","shipping_tracking_number":4321,"shipping_date":"2017-01-02T13:00:00+00:00"}]}}
```

Response:
```
HTTP/1.1 200 OK
{"dispute_evidence":{"id":819974671,"payments_dispute_id":598735659,"access_activity_log":"https://example.com/access-activity-log","billing_address":{"id":867402159,"address1":"1 Infinite Loop","address2":"Muppet Studio","city":"Cupertino","province":"California","province_code":"CA","country":"United States","country_code":"US","zip":"95014"},"cancellation_policy_disclosure":"https://example.com/cancellation-policy","cancellation_rebuttal":"https://example.com/cancellation-rebuttal","customer_email_address":"customer@example.com","customer_first_name":"John","customer_last_name":"Doe","product_description":"Product name: Draft\nTitle: 151cm\nPrice: $10.00\nQuantity: 1\nProduct Description: good board","refund_policy_disclosure":"https://example.com/refund-policy","refund_refusal_explanation":"Product must have receipt of proof of purchase","shipping_address":{"id":867402159,"address1":"1 Infinite Loop","address2":"Muppet Studio","city":"Cupertino","province":"California","province_code":"CA","country":"United States","country_code":"US","zip":"95014"},"uncategorized_text":"Any additional notes","created_at":"2025-01-02T11:09:43-05:00","updated_at":"2025-01-02T11:22:43-05:00","submitted_by_merchant_on":null,"fulfillments":[{"shipping_carrier":"UPS","shipping_tracking_number":"1234","shipping_date":"2017-01-01"},{"shipping_carrier":"FedEx","shipping_tracking_number":"4321","shipping_date":"2017-01-02"},{"shipping_carrier":"FedEx","shipping_tracking_number":"4321","shipping_date":"2017-01-02"}],"dispute_evidence_files":{"cancellation_policy_file_id":null,"customer_communication_file_id":539650252,"customer_signature_file_id":799719586,"refund_policy_file_id":null,"service_documentation_file_id":null,"shipping_documentation_file_id":799719586,"uncategorized_file_id":567271523}}}
```