# Dispute Evidence

## Definitions

### evidence_token
- **Type:** uuid  
- **Required:** Yes

### dispute_token
- **Type:** uuid  
- **Required:** Yes

## Response Structure

### 200 OK
#### Object
- **created**  
  - **Type:** date-time  
  - **Required:** Yes  
  - *Description:* Timestamp of when dispute evidence was created.
- **dispute_token**  
  - **Type:** uuid  
  - **Required:** Yes  
  - *Description:* Dispute token evidence is attached to.
- **download_url**  
  - **Type:** string  
  - *Description:* URL to download evidence. Only shown when `upload_status` is `UPLOADED`.
- **filename**  
  - **Type:** string  
  - *Description:* File name of evidence. Recommended to give the dispute evidence a human-readable identifier.
- **token**  
  - **Type:** uuid  
  - **Required:** Yes  
  - *Description:* Globally unique identifier.
- **upload_status**  
  - **Type:** string (enum)  
  - **Required:** Yes  
  - *Description:* Upload status types:
    - `DELETED` - Evidence was deleted.
    - `ERROR` - Evidence upload failed.
    - `PENDING` - Evidence is pending upload.
    - `REJECTED` - Evidence was rejected.
    - `UPLOADED` - Evidence was uploaded.
- **upload_url**  
  - **Type:** string  
  - *Description:* URL to upload evidence. Only shown when `upload_status` is `PENDING`.

## Error Responses
### 400 Bad Request
- *Description:* A parameter in the query given in the request does not match the valid queries for the endpoint.
### 401 Unauthorized
| Description | Reason |
| --- | --- |
| User has not been authenticated | Invalid or missing API key |
| API key is not active | The API key used is no longer active |
| Could not find API key | The API key provided is not associated with any user |
| Please provide API key in Authorization header | The Authorization header is not in the request |
| Please provide API key in the form Authorization: [api-key] | The Authorization header is not formatted properly |
| Insufficient privileges. Issuing API key required | Write access requires an Issuing API key. Reach out at [lithic.com/contact](/content/contact/index.html) |
| Insufficient privileges to create virtual cards. | Creating virtual cards requires an additional privilege |

### 404 Not Found
- *Description:* The specified resource was not found.

### 429 Too Many Requests
| Description | Reason |
| --- | --- |
| Rate limited, too many requests per second | User has exceeded their per second rate limit |
| Rate limited, reached daily limit | User has exceeded their daily rate limit |
| Rate limited, too many keys tried | One IP has queried too many different API keys |

## Example

### cURL Request
```shell
curl --request GET \
     --url https://sandbox.lithic.com/v1/disputes/dispute_token/evidences/evidence_token \
     --header 'accept: application/json'
```

### Sample Response
```json
{
  "created": "2026-07-18T00:25:22.549Z",
  "dispute_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "download_url": "string",
  "filename": "string",
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "upload_status": "DELETED",
  "upload_url": "string"
}
```