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

# List Jobs

> List all batch jobs for the current user

## Query Parameters

<ParamField query="status" type="string">
  Filter by status: `pending`, `processing`, `completed`, `failed`
</ParamField>

<ParamField query="limit" type="integer" default="20">
  Number of results (max 100)
</ParamField>

<ParamField query="offset" type="integer" default="0">
  Number of results to skip
</ParamField>

## Response

<ResponseField name="items" type="array" required>
  Array of job objects
</ResponseField>

<ResponseField name="total" type="integer" required>
  Total number of jobs
</ResponseField>

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

  ```typescript TypeScript theme={null}
  const jobs = await client.jobs.listJobsV1JobsGet({
    status: "completed",
    limit: 10,
  });
  ```
</RequestExample>

<ResponseExample>
  ```json 200 theme={null}
  {
    "items": [
      {
        "job_id": "job_abc123",
        "status": "completed",
        "progress": 100,
        "total_items": 3,
        "created_at": "2024-01-15T10:30:00Z"
      },
      {
        "job_id": "job_def456",
        "status": "completed",
        "progress": 100,
        "total_items": 5,
        "created_at": "2024-01-14T09:00:00Z"
      }
    ],
    "total": 25,
    "limit": 10,
    "offset": 0,
    "has_more": true
  }
  ```
</ResponseExample>