---
title: "Provide dispute evidence"
method: PUT
path: "/disputes/{dispute_id}/evidence"
tags: ["Disputes"]
---

# Provide dispute evidence

`PUT /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: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `string` scopes: `disputes`, `disputes:provide-evidence`
  - API key in header `Authorization`
- TypeScript: <https://skmtc.dev/checkout/apis/checkout-com-api-reference/docs/disputes/:dispute_id/evidence/put.ts> (a function with typed inputs; its response is checked against the schema)

Adds supporting evidence to a dispute. Before using this endpoint, you first need to [upload your files](#tag/Disputes/paths/~1files/post) using the file uploader. You will receive a file id (prefixed by `file_`) which you can then use in your request. Note that this only attaches the evidence to the dispute, it does not send it to us. Once ready, you will need to submit it. **You must provide at least one evidence type in the body of your request.**

## Path parameters

- `dispute_id` string, required

## Request body

- ProvideEvidenceRequest
  - `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 invoice showing 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 customer communication.
  - `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 refund/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.
  - `_links` object
    - `self` object: The evidence retrieval endpoint.
      - `href` string
    - `parent` object: The dispute retrieval endpoint.
      - `href` string

## Response `204`

Dispute evidence provided successfully

## Other responses

- `400`: Unprocessable
- `401`: Unauthorized
- `404`: Dispute not found
- `422`: Unprocessable entity

---

[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)