Skip to main content
GET
List all files
Retrieve a paginated list of all files across all cases belonging to the authenticated user. This endpoint provides a comprehensive view of file metadata, analysis status, and risk scores.

Key Features

  • Pagination: Use limit and offset query parameters for large result sets.
  • Reverse Chronological: Files are returned newest first.
  • Unified View: See all user files regardless of which case they belong to.

Best Practices

  1. Batch Processing: Use a limit of 100 for batch background processing.
  2. UI Display: Use a limit of 20-50 for optimal UI performance and loading speed.
  3. Status Filtering: Check the analysis_status to determine which files have completed forensic review.

Authorizations

x-api-key
string
header
required

Query Parameters

limit
integer
default:50

Maximum number of files to return

Required range: 1 <= x <= 100
offset
integer
default:0

Number of files to skip for pagination

Required range: 0 <= x <= 9007199254740991
sort_by
enum<string>
default:date_created

Field to sort by

Available options:
date_created,
risk_score
sort_order
enum<string>
default:desc

Sort order: asc (ascending) or desc (descending)

Available options:
asc,
desc

Response

File list retrieved successfully

files
object[]
required
total
number
required