List Files

Retrieve a list of uploaded files filtered by case and purpose.

Parameters

Parameter	Type	Required	Description
caseId	string	Yes	Case ID to retrieve files from
purpose	string	Yes	File purpose filter: vehicle_photo, edr_document, or tcr_document

Response

Returns an array of file objects, each containing:

• fileId: Unique file identifier
• filename: Original filename
• size: File size in bytes
• created: Upload timestamp (Unix seconds)

Examples

Go

import "github.com/silentwitness/go-sdk"

silentwitness.Key = "sk_test_..."
response, err := silentwitness.Files.List(ctx, &silentwitness.ListFilesRequest{
    CaseId:  "case_1234567890abcdef",
    Purpose: "vehicle_photo",
})
if err != nil {
    log.Fatal(err)
}

for _, file := range response.Files {
    fmt.Printf("File: %s (%d bytes)\n", file.Filename, file.Size)
}

TypeScript

import { setApiKey, listFiles } from "@silentwitness/typescript-sdk";

setApiKey("sk_test_...");
const response = await listFiles({
    caseId: "case_1234567890abcdef",
    purpose: "vehicle_photo"
});

response.files.forEach(file => {
    console.log(`File: ${file.filename} (${file.size} bytes)`);
});

Errors

Code	Description
INVALID_ARGUMENT	Missing or invalid required parameters
NOT_FOUND	Case does not exist
PERMISSION_DENIED	Case not accessible with provided API key
UNAUTHENTICATED	Invalid or missing API key