---
title: Dispute Evidence
description: Get information regarding Shopify Payments dispute evidences.
api_version: unstable
api_name: admin-rest
api_type: rest
source_url:
  html: https://shopify.dev/docs/api/admin-rest/unstable/resources/dispute-evidence
  md: https://shopify.dev/docs/api/admin-rest/unstable/resources/dispute-evidence.md
---

![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)

The REST Admin API is a legacy API as of October 1, 2024. Starting April 1, 2025, all new public apps must be built exclusively with the [GraphQL Admin API](https://shopify.dev/docs/api/admin-graphql). For details and migration steps, visit our [migration guide](https://shopify.dev/docs/apps/build/graphql/migrate).

# Dispute Evidence

Requires `shopify_payments_dispute_evidences` access scope.

Dispute evidence is submitted by the merchant to support the legitimacy of a [dispute ](https://shopify.dev/docs/admin-api/rest/reference/shopify_payments/dispute).

\#

## Endpoints

* [get](https://shopify.dev/docs/api/admin-rest/unstable/resources/dispute-evidence#get-shopify-payments-disputes-dispute-id-dispute-evidences)

  [/admin/api/unstable/shopify\_​payments/disputes/{dispute\_​id}/dispute\_​evidences.​json](https://shopify.dev/docs/api/admin-rest/unstable/resources/dispute-evidence#get-shopify-payments-disputes-dispute-id-dispute-evidences)

  Returns evidence associated with the dispute

  [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/disputeEvidence?example=returns-evidence-associated-with-the-dispute)

  [disputeEvidence](https://shopify.dev/docs/api/admin-graphql/latest/queries/disputeEvidence?example=returns-evidence-associated-with-the-dispute)

* [put](https://shopify.dev/docs/api/admin-rest/unstable/resources/dispute-evidence#put-shopify-payments-disputes-dispute-id-dispute-evidences)

  [/admin/api/unstable/shopify\_​payments/disputes/{dispute\_​id}/dispute\_​evidences.​json](https://shopify.dev/docs/api/admin-rest/unstable/resources/dispute-evidence#put-shopify-payments-disputes-dispute-id-dispute-evidences)

  Updates dispute evidence

  [![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/mutations/disputeEvidenceUpdate?example=updates-dispute-evidence)

  [disputeEvidenceUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/disputeEvidenceUpdate?example=updates-dispute-evidence)

***

## The Dispute Evidence resource

### Properties

***

id

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.id)

[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.id)

The ID of the dispute evidence.

***

payments\_dispute\_id

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDispute#field-ShopifyPaymentsDispute.fields.id)

[id](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDispute#field-ShopifyPaymentsDispute.fields.id)

The ID of the dispute that the dispute evidence belongs to.

***

access\_activity\_log

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.accessActivityLog)

[accessActivityLog](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.accessActivityLog)

The activity logs associated with the dispute evidence.

***

customer\_email\_address

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerEmailAddress)

[customerEmailAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerEmailAddress)

The customer's email address.

***

customer\_first\_name

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerFirstName)

[customerFirstName](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerFirstName)

The customer's first name.

***

customer\_last\_name

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerLastName)

[customerLastName](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerLastName)

The customer's last name.

***

uncategorized\_text

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.uncategorizedText)

[uncategorizedText](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.uncategorizedText)

The uncategorized text for the dispute evidence.

***

shipping\_address

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.shippingAddress)

[shippingAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.shippingAddress)

The mailing address for shipping that is provided by the customer.

***

cancellation\_policy\_disclosure

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.cancellationPolicyDisclosure)

[cancellationPolicyDisclosure](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.cancellationPolicyDisclosure)

The cancellation policy disclosure associated with the dispute evidence.

***

cancellation\_rebuttal

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.cancellationRebuttal)

[cancellationRebuttal](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.cancellationRebuttal)

The cancellation rebuttal associated with the dispute evidence.

***

refund\_policy\_disclosure

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.refundPolicyDisclosure)

[refundPolicyDisclosure](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.refundPolicyDisclosure)

The refund policy disclosure associated with the dispute evidence.

***

refund\_refusal\_explanation

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.refundRefusalExplanation)

[refundRefusalExplanation](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.refundRefusalExplanation)

The refund refusal explanation associated with the dispute evidence.

***

{}

## The Dispute Evidence resource

```json
{
  "id": 54534554564,
  "payments_dispute_id": 54534554564,
  "access_activity_log": "Test access activity logs",
  "customer_email_address": "kermit@shopify.com",
  "customer_first_name": "Kermit",
  "customer_last_name": "The Frog",
  "uncategorized_text": "Other compelling text for dispute",
  "shipping_address": {
    "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": "Test cancellation policy disclosure",
  "cancellation_rebuttal": "Test cancellation rebuttal",
  "refund_policy_disclosure": "Test refund policy disclosure",
  "refund_refusal_explanation": "Test refund refusal explanation",
  "product_description": {
    "Product name": "Draft",
    "Title": "151cm",
    "Price": "$10.00",
    "Quantity": "1",
    "Product Description": "good board"
  },
  "submitted": false,
  "created_at": "2022-01-09T11:00:00-05:00",
  "updated_on": "2022-01-09T11:00:00-05:00",
  "dispute_evidence_files": {
    "cancellation_policy_file_id": null,
    "customer_communication_file_id": null,
    "customer_signature_file_id": null,
    "refund_policy_file_id": null,
    "service_documentation_file_id": null,
    "shipping_documentation_file_id": null,
    "uncategorized_file_id": 1
  },
  "billing_address": {
    "address1": "1 Infinite Loop",
    "address2": "Muppet Studio",
    "city": "Cupertino",
    "zip": "95014",
    "country": "United States",
    "country_code": "US",
    "province": "California",
    "province_code": "CA"
  },
  "fulfillments": [
    {
      "shipping_carrier": "FedEx",
      "shipping_tracking_number": 4321,
      "shipping_date": "2017-01-02T13:00:00+00:00"
    }
  ]
}
```

***

## getReturns evidence associated with the dispute

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/queries/disputeEvidence?example=returns-evidence-associated-with-the-dispute)

[disputeEvidence](https://shopify.dev/docs/api/admin-graphql/latest/queries/disputeEvidence?example=returns-evidence-associated-with-the-dispute)

Retrieves evidence associated with dispute ID.

### Parameters

***

api\_version

string

required

***

dispute\_id

string

required

***

### Examples

Retrieves dispute evidence by dispute ID

Path parameters

dispute\_​id=​598735659

string

required

get

## /admin/api/unstable/shopify\_​payments/disputes/598735659/dispute\_​evidences.​json

```bash
curl -X GET "https://your-development-store.myshopify.com/admin/api/unstable/shopify_payments/disputes/598735659/dispute_evidences.json" \
-H "X-Shopify-Access-Token: {access_token}"
```

{}

## Response

JSON

```json
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-10-01T14:30:56-04:00",
    "updated_at": "2025-10-01T14:56:08-04: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
    }
  }
}
```

### examples

* #### Retrieves dispute evidence by dispute ID

  #####

  ```curl
  curl -X GET "https://your-development-store.myshopify.com/admin/api/unstable/shopify_payments/disputes/598735659/dispute_evidences.json" \
  -H "X-Shopify-Access-Token: {access_token}"
  ```

  #####

  ```remix
  const client = new shopify.clients.Rest({session});
  const data = await client.get({
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
  });
  ```

  #####

  ```ruby
  session = ShopifyAPI::Auth::Session.new(
    shop: "your-development-store.myshopify.com",
    access_token: access_token
  )
  client = ShopifyAPI::Clients::Rest::Admin.new(
    session: session
  )

  response = client.get(
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
  )
  ```

  #####

  ```node
  const client = new shopify.clients.Rest({session});
  const data = await client.get({
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
  });
  ```

  #### response

  ```json
  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-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:56:08-04: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}}}
  ```

***

## putUpdates dispute evidence

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/mutations/disputeEvidenceUpdate?example=updates-dispute-evidence)

[disputeEvidenceUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/disputeEvidenceUpdate?example=updates-dispute-evidence)

Updates dispute evidence associated with the dispute ID.

### Parameters

***

api\_version

string

required

***

dispute\_id

string

required

***

### Examples

Submits dispute evidence request

Path parameters

dispute\_​id=​598735659

string

required

Update dispute evidence's information

Path parameters

dispute\_​id=​598735659

string

required

Request body

dispute\_​evidence​

Dispute\_evidence resource

Show dispute\_evidence properties

dispute\_​evidence.access\_​activity\_​log:​"https\://example.com/access-activity-log"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-accessActivityLog)

[accessActivityLog](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-accessActivityLog)

The activity logs associated with the dispute evidence.

dispute\_​evidence.cancellation\_​policy\_​disclosure:​"https\://example.com/cancellation-policy"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-cancellationPolicyDisclosure)

[cancellationPolicyDisclosure](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-cancellationPolicyDisclosure)

The cancellation policy disclosure associated with the dispute evidence.

dispute\_​evidence.cancellation\_​rebuttal:​"https\://example.com/cancellation-rebuttal"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-cancellationRebuttal)

[cancellationRebuttal](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-cancellationRebuttal)

The cancellation rebuttal associated with the dispute evidence.

dispute\_​evidence.customer\_​email\_​address:​"customer\@example.com"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-customerEmailAddress)

[customerEmailAddress](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-customerEmailAddress)

The customer's email address.

dispute\_​evidence.customer\_​first\_​name:​"John"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-customerFirstName)

[customerFirstName](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-customerFirstName)

The customer's first name.

dispute\_​evidence.customer\_​last\_​name:​"Doe"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-customerLastName)

[customerLastName](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-customerLastName)

The customer's last name.

dispute\_​evidence.refund\_​policy\_​disclosure:​"https\://example.com/refund-policy"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-refundPolicyDisclosure)

[refundPolicyDisclosure](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-refundPolicyDisclosure)

The refund policy disclosure associated with the dispute evidence.

dispute\_​evidence.refund\_​refusal\_​explanation:​"Product must have receipt of proof of purchase"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-refundRefusalExplanation)

[refundRefusalExplanation](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-refundRefusalExplanation)

The refund refusal explanation associated with the dispute evidence.

dispute\_​evidence.uncategorized\_​text:​"Any additional notes"

->

[![](https://shopify.dev/images/logos/GraphQL.svg)![](https://shopify.dev/images/logos/GraphQL-dark.svg)](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-uncategorizedText)

[uncategorizedText](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-uncategorizedText)

The uncategorized text for the dispute evidence.

put

## /admin/api/unstable/shopify\_​payments/disputes/598735659/dispute\_​evidences.​json

```bash
curl -d '{"dispute_evidence":{"submit_evidence":true}}' \
-X PUT "https://your-development-store.myshopify.com/admin/api/unstable/shopify_payments/disputes/598735659/dispute_evidences.json" \
-H "X-Shopify-Access-Token: {access_token}" \
-H "Content-Type: application/json"
```

{}

## Response

JSON

```json
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-10-01T14:30:56-04:00",
    "updated_at": "2025-10-01T14:56:10-04:00",
    "submitted_by_merchant_on": "2025-10-01T14:56:10-04: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
    }
  }
}
```

### examples

* #### Submits dispute evidence request

  #####

  ```curl
  curl -d '{"dispute_evidence":{"submit_evidence":true}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/unstable/shopify_payments/disputes/598735659/dispute_evidences.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #####

  ```remix
  import { DataType } from '@shopify/shopify-api';

  const client = new shopify.clients.Rest({session});
  const data = await client.put({
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
    data: {"dispute_evidence":{"submit_evidence":true}},
    type: DataType.JSON,
  });
  ```

  #####

  ```ruby
  session = ShopifyAPI::Auth::Session.new(
    shop: "your-development-store.myshopify.com",
    access_token: access_token
  )
  client = ShopifyAPI::Clients::Rest::Admin.new(
    session: session
  )

  response = client.put(
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
    body: {
      "dispute_evidence": {
        "submit_evidence": true
      }
    },
  )
  ```

  #####

  ```node
  import { DataType } from '@shopify/shopify-api';

  const client = new shopify.clients.Rest({session});
  const data = await client.put({
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
    data: {"dispute_evidence":{"submit_evidence":true}},
    type: DataType.JSON,
  });
  ```

  #### response

  ```json
  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-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:56:10-04:00","submitted_by_merchant_on":"2025-10-01T14:56:10-04: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

  #####

  ```curl
  curl -d '{"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"}]}}' \
  -X PUT "https://your-development-store.myshopify.com/admin/api/unstable/shopify_payments/disputes/598735659/dispute_evidences.json" \
  -H "X-Shopify-Access-Token: {access_token}" \
  -H "Content-Type: application/json"
  ```

  #####

  ```remix
  import { DataType } from '@shopify/shopify-api';

  const client = new shopify.clients.Rest({session});
  const data = await client.put({
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
    data: {"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"}]}},
    type: DataType.JSON,
  });
  ```

  #####

  ```ruby
  session = ShopifyAPI::Auth::Session.new(
    shop: "your-development-store.myshopify.com",
    access_token: access_token
  )
  client = ShopifyAPI::Clients::Rest::Admin.new(
    session: session
  )

  response = client.put(
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
    body: {
      "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"}]
      }
    },
  )
  ```

  #####

  ```node
  import { DataType } from '@shopify/shopify-api';

  const client = new shopify.clients.Rest({session});
  const data = await client.put({
    path: 'shopify_payments/disputes/598735659/dispute_evidences',
    data: {"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"}]}},
    type: DataType.JSON,
  });
  ```

  #### response

  ```json
  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-10-01T14:30:56-04:00","updated_at":"2025-10-01T14:56:07-04: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}}}
  ```