List Files
Retrieves a list of all files owned by the authenticated user. Returns file metadata including ID, name, creation date, visibility, and encryption status.
List Files
Retrieves a list of all files owned by the authenticated user. Returns file metadata including ID, name, creation date, visibility, and encryption status.
API Endpoint
GET /analysis/file/list
HTTP Headers
- X-Cursed-Api-Token: API token for authentication
Request Method
GET
Parameters
This endpoint does not require any parameters.
Response Format
Success Response (200 OK):
{
"files": [
[
"file_id (UUID)",
"file_name",
"creation_date",
"visibility (public|private)",
"encryption_status (encrypted|unencrypted)"
],
...
]
}
Response Schema
The response contains an array of file arrays, where each file array contains:
| Index | Field | Type | Description |
|---|---|---|---|
| 0 | file_id | string | UUID of the file |
| 1 | file_name | string | Original filename |
| 2 | creation_date | string | File creation timestamp (UTC) |
| 3 | visibility | string | File visibility ("public" or "private") |
| 4 | encryption_status | string | Encryption status ("encrypted" or "unencrypted") |
Error Response (401 Unauthorized):
{
"error": "Unauthorized"
}
Error Response (500 Internal Server Error):
{
"error": "Internal server error"
}
Error Codes
| HTTP Status | Description |
|---|---|
| 200 | Success - Files retrieved successfully |
| 401 | Unauthorized - Missing or invalid authentication |
| 500 | Internal Server Error - Server processing error |
Example cURL Command
curl -X GET https://api.cursedtools.com/analysis/file/list \
-H "X-Cursed-Api-Token: your_api_token"
Example Response
{
"files": [
[
"94ba8675-7cfd-44a2-b85f-a3fa1bda69de",
"malware_sample.exe",
"2024-01-15 10:30:00 UTC",
"private",
"encrypted"
],
[
"456e7890-e89b-12d3-a456-426614174001",
"system_logs.evtx",
"2024-01-15 11:45:00 UTC",
"public",
"unencrypted"
],
[
"412e2e3b-d10b-4a77-850a-974aec0dcfb5",
"network_traffic.pcap",
"2024-01-15 14:20:00 UTC",
"private",
"encrypted"
]
]
}
Notes
- Only authenticated users can access this endpoint
- Only files owned by the authenticated user are returned
- Files are returned in the order they were created
- The response format is an array of arrays for efficient data transfer
- Private files are encrypted and can only be accessed by the owner
- Public files are unencrypted and can be accessed by anyone with the file ID