> ## Documentation Index
> Fetch the complete documentation index at: https://docs.clustr-ai.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List Jobs

> List import jobs with optional status filter

List import jobs, optionally filtered by status.

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `PROCESSING`, `COMPLETED`, `FAILED` (comma-separated for multiple)
</ParamField>

<ParamField query="limit" type="integer" default="100">
  Max results to return (max: 1000)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Offset for pagination
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://api.clustr-ai.com/api/public/jobs?status=COMPLETED&limit=10" \
    -H "Authorization: Bearer YOUR_API_KEY"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "success": true,
    "data": {
      "jobs": [
        {
          "job_id": "job_abc123",
          "status": "COMPLETED",
          "progress": {
            "current_stage": "completed",
            "stages": {}
          },
          "created_at": "2025-03-15T10:00:00Z",
          "completed_at": "2025-03-15T10:05:00Z"
        }
      ],
      "total": 1
    }
  }
  ```
</ResponseExample>