--- title: Dispute Evidence description: Get information regarding Shopify Payments dispute evidences. api_version: 2026-07 source_url: html: 'https://shopify.dev/docs/api/admin-rest/latest/resources/dispute-evidence' md: 'https://shopify.dev/docs/api/admin-rest/latest/resources/dispute-evidence.md' api_name: admin-rest api_type: rest --- 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/latest/resources/dispute-evidence.md#get-shopify-payments-disputes-dispute-id-dispute-evidences) [/admin/api/latest/shopify\_​payments/disputes/{dispute\_​id}/dispute\_​evidences.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/dispute-evidence.md#get-shopify-payments-disputes-dispute-id-dispute-evidences) 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/latest/resources/dispute-evidence.md#put-shopify-payments-disputes-dispute-id-dispute-evidences) [/admin/api/latest/shopify\_​payments/disputes/{dispute\_​id}/dispute\_​evidences.​json](https://shopify.dev/docs/api/admin-rest/latest/resources/dispute-evidence.md#put-shopify-payments-disputes-dispute-id-dispute-evidences) Updates dispute evidence [disputeEvidenceUpdate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/disputeEvidenceUpdate?example=updates-dispute-evidence) *** ## The Dispute Evidence resource ### Properties *** 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 ->[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 ->[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 ->[customerEmailAddress](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerEmailAddress) The customer's email address. *** customer\_first\_name ->[customerFirstName](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerFirstName) The customer's first name. *** customer\_last\_name ->[customerLastName](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.customerLastName) The customer's last name. *** uncategorized\_text ->[uncategorizedText](https://shopify.dev/docs/api/admin-graphql/latest/objects/ShopifyPaymentsDisputeEvidence#field-ShopifyPaymentsDisputeEvidence.fields.uncategorizedText) The uncategorized text for the dispute evidence. *** shipping\_address ->[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 ->[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 ->[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 ->[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 ->[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, "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 [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/2026-07/shopify\_​payments/disputes/598735659/dispute\_​evidences.​json ```bash curl -X GET "https://your-development-store.myshopify.com/admin/api/2026-07/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": "2026-07-02T10:36:00-04:00", "updated_at": "2026-07-02T10:47:46-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, "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/2026-07/shopify_payments/disputes/598735659/dispute_evidences.json" \ -H "X-Shopify-Access-Token: {access_token}" ``` #### 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":"2026-07-02T10:36:00-04:00","updated_at":"2026-07-02T10:47:46-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,"refund_policy_file_id":null,"service_documentation_file_id":null,"shipping_documentation_file_id":799719586,"uncategorized_file_id":567271523}}} ``` *** ## putUpdates 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** dispute\_​evidence.access\_​activity\_​log:​"https://example.com/access-activity-log" ->[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" ->[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" ->[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" ->[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" ->[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" ->[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" ->[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" ->[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" ->[uncategorizedText](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/ShopifyPaymentsDisputeEvidenceUpdateInput#fields-uncategorizedText) The uncategorized text for the dispute evidence. put ## /admin/api/2026-07/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/2026-07/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": "2026-07-02T10:36:00-04:00", "updated_at": "2026-07-02T10:47:47-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, "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/2026-07/shopify_payments/disputes/598735659/dispute_evidences.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/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":"2026-07-02T10:36:00-04:00","updated_at":"2026-07-02T10:47:47-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,"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/2026-07/shopify_payments/disputes/598735659/dispute_evidences.json" \ -H "X-Shopify-Access-Token: {access_token}" \ -H "Content-Type: application/json" ```