# List all jobs

> Source: https://scrape.do/documentation/async-api/list-jobs/

Get a paginated list of jobs with filtering and sorting support

Get a paginated list of all scraping jobs for your account. Supports filtering by status and date range, and sorting by start time.

## Query Parameters

| Parameter | Type | Default | Description |
|-----------|------|---------|-------------|
| `page_size` | integer | `10` | Number of jobs per page (max `100`) |
| `page` | integer | `1` | Page number (minimum `1`) |
| `status` | string | — | Filter by job status. Allowed values: `queuing`, `queued`, `pending`, `rotating`, `success`, `error`, `canceled` |
| `start_from` | string | — | RFC3339 timestamp. Returns jobs where `start_time >= start_from`. Example: `2025-01-01T00:00:00Z` |
| `start_to` | string | — | RFC3339 timestamp. Returns jobs where `start_time <= start_to`. Example: `2025-01-31T23:59:59Z` |
| `sort` | string | `start_time_desc` | Sort order. Allowed values: `start_time_asc`, `start_time_desc` |

> [!NOTE]
> Timestamps are case-sensitive. Always use the RFC3339 format with uppercase `T` and `Z` (e.g. `2025-01-01T00:00:00Z`). Invalid values for any filter parameter return `400 Bad Request`.

## Examples

```bash
# Get the 10 most recent jobs
curl 'https://q.scrape.do/api/v1/jobs' \
  --header 'X-Token: YOUR_TOKEN'

# Filter by status
curl 'https://q.scrape.do/api/v1/jobs?status=success' \
  --header 'X-Token: YOUR_TOKEN'

# Filter by date range
curl 'https://q.scrape.do/api/v1/jobs?start_from=2025-01-01T00:00:00Z&start_to=2025-01-31T23:59:59Z' \
  --header 'X-Token: YOUR_TOKEN'

# Sort oldest first, page 2
curl 'https://q.scrape.do/api/v1/jobs?sort=start_time_asc&page=2&page_size=25' \
  --header 'X-Token: YOUR_TOKEN'

# Combined: successful jobs this month, newest first
curl 'https://q.scrape.do/api/v1/jobs?status=success&start_from=2025-01-01T00:00:00Z&sort=start_time_desc' \
  --header 'X-Token: YOUR_TOKEN'
```

## Response

```json
{
  "Jobs": [
    {
      "JobID": "550e8400-e29b-41d4-a716-446655440000",
      "Status": "success",
      "TaskIDs": ["660e8400-e29b-41d4-a716-446655440001"],
      "StartTime": "2025-01-15T10:00:00Z",
      "EndTime": "2025-01-15T10:00:05Z"
    }
  ],
  "TotalCount": 150,
  "PageSize": 10,
  "PageNumber": 1,
  "TotalPages": 15
}
```

### Job Status Values

| Status | Description |
|--------|-------------|
| `queuing` | Job is being prepared |
| `queued` | Job is in queue waiting to be processed |
| `pending` | Job is currently being processed |
| `rotating` | Job is retrying with different proxies |
| `success` | Job completed successfully |
| `error` | Job failed |
| `canceled` | Job was canceled |