# API Parameters

## dispute_token
- **uuid**: required

## begin
- **date-time**: Date string in RFC 3339 format. Only entries created after the specified time will be included. UTC time zone.

## end
- **date-time**: Date string in RFC 3339 format. Only entries created before the specified time will be included. UTC time zone.

## ending_before
- **string**: A cursor representing an item's token before which a page of results should end. Used to retrieve the previous page of results before this item.

## page_size
- **integer**: 1 to 100. Defaults to 50. Page size (for pagination).

## starting_after
- **string**: A cursor representing an item's token after which a page of results should begin. Used to retrieve the next page of results after this item.

# Response Codes

## `200 OK`
- **object**  
  - **data**: array of objects (required)
    - **data**: object  
      - **created**: date-time (required): Timestamp of when dispute evidence was created.
      - **dispute_token**: uuid (required): Dispute token evidence is attached to.
      - **download_url**: string: URL to download evidence. Only shown when `upload_status` is `UPLOADED`.
      - **filename**: string: File name of evidence. Recommended to give the dispute evidence a human-readable identifier.
      - **token**: uuid (required): Globally unique identifier.
      - **upload_status**: string (enum, required): 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**: string: URL to upload evidence. Only shown when `upload_status` is `PENDING`.
  - **has_more**: boolean (required): More data exists.

## Error Responses

### `400 Bad Request`
- A parameter in the query given in the request does not match the valid queries for the endpoint.

### `401 Unauthorized`
| Message | Description |
| --- | --- |
| 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`
- The specified resource was not found.

### `429 Too Many Requests`
| Message | Description |
| --- | --- |
| 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 Request

```shell
curl --request GET \
     --url 'https://sandbox.lithic.com/v1/disputes/dispute_token/evidences?page_size=50' \
     --header 'accept: application/json'
```

# Example Response

```json
{
  "data": [
    {
      "created": "2026-07-18T00:25:21.273Z",
      "dispute_token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "download_url": "string",
      "filename": "string",
      "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
      "upload_status": "DELETED",
      "upload_url": "string"
    }
  ],
  "has_more": true
}
```