--- title: "Get dispute evidence" method: GET path: "/disputes/{dispute_id}/evidence" tags: ["Disputes"] --- # Get dispute evidence `GET /disputes/{dispute_id}/evidence` ## Request - Base URL: `https://{prefix}.api.sandbox.checkout.com` - URL: `https://{prefix}.api.sandbox.checkout.com/disputes/{dispute_id}/evidence` - Auth: OAuth 2 - Client credentials - Token URL: `string` scopes: `disputes`, `disputes:view` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieves a list of the evidence submitted in response to a specific dispute. ## Path parameters - `dispute_id` string, required ## Response `200` Dispute evidence retrieved successfully - Evidence - `proof_of_delivery_or_service_file` string: A file containing proof of delivery of goods or services. - `proof_of_delivery_or_service_text` string: A brief description of the file provided in `proof_of_delivery_or_service_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `proof_of_delivery_or_service_date_file` string: A file showing the delivery date of the provided service or merchandise. - `proof_of_delivery_or_service_date_text` string: A brief description of the file provided in `proof_of_delivery_or_service_date_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `invoice_or_receipt_file` string: A file containing an invoice or receipt. - `invoice_or_receipt_text` string: A brief description of the file provided in `invoice_or_receipt_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `invoice_showing_distinct_transactions_file` string: A file containing an invoice which shows two distinct transactions. - `invoice_showing_distinct_transactions_text` string: A brief description of the file provided in `invoice_showing_distinct_transactions_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `customer_communication_file` string: A file containing proof of communication with the customer. - `customer_communication_text` string: A brief description of the file provided in `customer_communication_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `refund_or_cancellation_policy_file` string: A file containing the refund or cancellation policy. - `refund_or_cancellation_policy_text` string: A brief description of the file provided in `refund_or_cancellation_policy_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `recurring_transaction_agreement_file` string: A file containing the recurring transaction agreement. - `recurring_transaction_agreement_text` string: A brief description of the file provided in `recurring_transaction_agreement_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `additional_evidence_file` string: A file containing additional supporting documents. - `additional_evidence_text` string: A brief description of the file provided in `additional_evidence_file`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `arbitration_no_review_files` string[]: The evidence to submit directly to the scheme when you escalate the dispute to arbitration. Evidence you provide with this field is submitted directly to the scheme. - `arbitration_no_review_text` string: A brief description of the file provided in `arbitration_no_review_files`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `arbitration_review_required_files` string[]: The evidence to submit to the Checkout.com Dispute Resolution team for review. You'll be advised on the likelihood of success if you choose to escalate the dispute to arbitration. - `arbitration_review_required_text` string: A brief description of the file provided in `arbitration_review_required_files`. Alternatively, you can provide a link to an externally-hosted file containing the description. - `compelling_evidence` CompellingEvidence - `merchandise_or_service` string, required: Value can be either "Merchandise" or "Services". - `merchandise_or_service_desc` string, required: Description of the merchandise or service that this transaction was for. - `merchandise_or_service_provided_date` string, date-time, required: The date and time the merchandise or service was provided, in UTC format. - `shipping_delivery_status` string: Status of the order. Only valid if merchandise_or_services is equal to "Merchandise”. * `not_shipped` * `back_ordered` * `in_transit` * `partial_shipped` * `shipped` * `cancelled` * `shipping_exception` * `picked_up_by_customer` * `delivered` * `other` - `tracking_information` string: Tracking of the order. Only valid if merchandise_or_services is equal to "Merchandise”. Required if the shipping_delivery_status is any of the following: * `in_transit` * `partial_shipped` * `shipped` * `shipping_exception` * `delivered` * `other` - `user_id` string: User ID is synonymous to Customer Account/log in ID. - `ip_address` string: IpAddress used in the transaction. Should be either IPV4 or IPV6. - `device_id` string: Device used in the transaction. - `shipping_address` object: The shipping address provided for this transaction. - `address` string, required: It describes the main address. - `address2` string: Any additional information about the address. - `city` string, required: The name of the city. - `state_region` string: The state for the address. Required if the country is "US" or "CA" (Canada). - `postal_code` string, required: The postal code of the address. - `country` string, required: The three digit ISO code of the country. - `historical_transactions` object[], required: List of historical transactions. At least two transactions. - `historical_arn` string, required: The Acquirer reference number (ARN) of the capture transaction. - `merchandise_or_service_desc` string, required: Description of the merchandise or service that this transaction was for. ## Other responses - `401`: Unauthorized - `404`: Dispute not found --- [API](https://skmtc.dev/checkout/apis/checkout-com-api-reference.md) - [All operations](https://skmtc.dev/checkout/apis/checkout-com-api-reference/llms.txt) - [OpenAPI document](https://skmtc.dev/checkout/apis/checkout-com-api-reference/revisions/0f1abdb1c3e9?raw)