List Jobs
Retrieves a list of all analysis jobs owned by the authenticated user. Returns job metadata including ID, name, status, creation date, visibility, and job type.
List Jobs
Retrieves a list of all analysis jobs owned by the authenticated user. Returns job metadata including ID, name, status, creation date, visibility, and job type.
API Endpoint
GET /analysis/job/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):
{
"jobs": [
[
"job_id (UUID)",
"job_name",
"status",
"creation_date",
"visibility (public|private)",
"job_type"
],
...
]
}
Response Schema
The response contains an array of job arrays, where each job array contains:
| Index | Field | Type | Description |
|---|---|---|---|
| 0 | job_id | string | UUID of the job |
| 1 | job_name | string | Display name of the job |
| 2 | status | string | Job status ("Pending", "Processing", "Completed", "Failed") |
| 3 | creation_date | string | Job creation timestamp (UTC) |
| 4 | visibility | string | Job visibility ("public" or "private") |
| 5 | job_type | string | Type of analysis job ("winevtx", "sigma_file_community", "sigma_file_custom", etc.) |
Error Response (401 Unauthorized):
Unauthorized
Error Response (500 Internal Server Error):
An error occurred while processing your request. If you would like to report it contact us via the feedback form on cursed.tools/feedback and quote the following ID: [uuid]
Error Codes
| HTTP Status | Description |
|---|---|
| 200 | Success - Jobs 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/job/list \
-H "X-Cursed-Api-Token: your_api_token"
Example with API Token
curl -X GET https://api.cursedtools.com/analysis/job/list \
-H "X-Cursed-Api-Token: your_api_token"
Example Response
{
"jobs": [
[
"123e4567-e89b-12d3-a456-426614174000",
"Arcane Wizard Craft",
"Completed",
"2024-01-15 10:30:00 UTC",
"private",
"winevtx"
],
[
"456e7890-e89b-12d3-a456-426614174001",
"Hungry House Dragon",
"Processing",
"2024-01-15 11:45:00 UTC",
"public",
"sigma_file_community"
],
[
"789e0123-e89b-12d3-a456-426614174002",
"Mecha Gizmo Force",
"Failed",
"2024-01-15 14:20:00 UTC",
"private",
"sigma_file_custom"
]
]
}
Job Status Values
| Status | Description |
|---|---|
Pending | Job is queued and waiting to be processed |
Processing | Job is currently being analyzed |
Completed | Job has finished successfully |
Failed | Job encountered an error during processing |
Job Type Values
| Type | Description |
|---|---|
winevtx | Windows Event Log analysis |
sigma_file_community | Sigma rule analysis using community rules |
sigma_file_custom | Sigma rule analysis using custom rules |
unknown | Unknown or legacy job type |
Notes
- Only authenticated users can access this endpoint
- Only jobs owned by the authenticated user are returned
- Jobs are returned in the order they were created
- The response format is an array of arrays for efficient data transfer
- Private jobs are encrypted and can only be accessed by the owner
- Public jobs are unencrypted and can be accessed by anyone with the job ID
- Job names are auto-generated using creative and memorable combinations if not set by the user