Parameters for Creating a Case File and Starting an Upload

case_token

uuid
required
Globally unique identifier for the case.

name

string
required
Name of the file to upload.

Case File

201 Case File

object
A file attached to a case. Status-dependent fields are always present but may be null:

• upload_url, upload_url_expires, and upload_constraints are populated when status is PENDING or REJECTED
• download_url and download_url_expires are populated when status is READY
• failure_reason is populated when status is REJECTED

Fields

token

uuid
required
Globally unique identifier for the file.

name

string
required
Name of the file.

mime_type

string | null
required
MIME type of the file, available once the file is ready.

size_bytes

int64 | null
required
Size of the file in bytes, available once the file is ready.

status

string
enum
required
Lifecycle status of a case file:

• PENDING
  An upload URL has been issued and the file is awaiting upload.
• READY
  The file has been uploaded and validated; a download URL is available.
• REJECTED
  File validation failed; see failure_reason for details.

upload_url

string | null
required
Presigned URL the client uses to upload the file.

upload_url_expires

date-time | null
required
Date and time at which the upload URL expires.

upload_constraints

nullUpload Constraints
required
Constraints that the uploaded file must satisfy.

download_url

string | null
required
Presigned URL the client uses to download the file.

download_url_expires

date-time | null
required
Date and time at which the download URL expires.

failure_reason

string | null
required
Reason the file was rejected, when applicable.

created

date-time
required
Date and time at which the file record was created.

updated

date-time
required
Date and time at which the file record was last updated.

Error Codes

• 400
  Bad Request

• 404
  Not Found

Example Request

curl --request POST \
     --url https://sandbox.lithic.com/v1/transaction_monitoring/cases/case_token/files \
     --header 'accept: application/json' \
     --header 'content-type: application/json' \
     --data '{"name":"string"}'

Example Response

{
  "token": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
  "name": "string",
  "mime_type": "string",
  "size_bytes": 0,
  "status": "PENDING",
  "upload_url": "string",
  "upload_url_expires": "2026-07-17T22:19:58.861Z",
  "upload_constraints": {
    "accepted_mime_types": ["string"],
    "max_size_bytes": 0
  },
  "download_url": "string",
  "download_url_expires": "2026-07-17T22:19:58.861Z",
  "failure_reason": "string",
  "created": "2026-07-17T22:19:58.861Z",
  "updated": "2026-07-17T22:19:58.861Z"
}