List evidence

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

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

Example Response

{
  "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
}