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

# Create dispute evidence

`PUT /disputes/{id}/evidence`

## Request

- Base URL: `https://api.justifi.ai/v1`
- URL: `https://api.justifi.ai/v1/disputes/{id}/evidence`
- Auth: none declared. Required headers: `Authorization`
- TypeScript: <https://skmtc.dev/justifi/apis/justifi-api-documentation/docs/disputes/:id/evidence/put.ts> (a function with typed inputs; its response is checked against the schema)

Creates dispute evidence and generate presigned url

> ⚠️ **Not available for Canada accounts**
>
> The dispute response and evidence endpoints are not available for Canada accounts.

## Path parameters

- `id` string, uuid, required

## Headers

- `Authorization` string, required

## Request body

- object
  - `file_name` string, required: dispute evidence file name
  - `file_type` 'image/jpeg' | 'image/png' | 'application/pdf' | 'application/zip' | 'application/x-zip-compressed', required: dispute evidence file type
  - `dispute_evidence_type` 'cancellation_policy' | 'customer_communication' | 'customer_signature' | 'duplicate_charge_documentation' | 'receipt' | 'refund_policy' | 'service_documentation' | 'shipping_documentation' | 'uncategorized_file', required: dispute evidence type matching the file that will be uploaded
  - `description` string: description of the dispute evidence file that will be uploaded
  - `metadata` object: any useful information you'd like to store alongside the dispute evidence

## Response `201`

Dispute evidence created and presigned url generated

- object
  - `id` string, uuid: the object id, also found in the data object
  - `type` string: the object type, or array of objects
  - `data` object: the attributes for the object
    - `id` string: unique dispute evidence id
    - `file_name` string: dispute evidence file name
    - `file_type` 'image/jpeg' | 'image/png' | 'application/pdf' | 'application/zip' | 'application/x-zip-compressed': dispute evidence file type
    - `dispute_evidence_type` 'cancellation_policy' | 'customer_communication' | 'customer_signature' | 'duplicate_charge_documentation' | 'receipt' | 'refund_policy' | 'service_documentation' | 'shipping_documentation' | 'uncategorized_file': dispute evidence type matching the file that will be uploaded
    - `status` 'pending' | 'uploaded': dispute evidence status
    - `description` string: description of the dispute evidence file that will be uploaded
    - `presigned_url` string: url that should be used to submit a put request to upload the evidence file
  - `page_info` unknown

---

[API](https://skmtc.dev/justifi/apis/justifi-api-documentation.md) - [All operations](https://skmtc.dev/justifi/apis/justifi-api-documentation/llms.txt) - [OpenAPI document](https://skmtc.dev/justifi/apis/justifi-api-documentation/revisions/dd9f3fed7e46?raw)