> ## Documentation Index
> Fetch the complete documentation index at: https://docs.datachecks.io/llms.txt
> Use this file to discover all available pages before exploring further.
# List Comparison Jobs
> List comparison jobs in the workspace with optional status, dataset, and time range filters.
Bearer token. Format: `Bearer `
Your workspace UUID.
Page number for pagination.
Number of results per page.
Search string to filter jobs by comparison name.
Comma-separated list of statuses to include. Example: `SUCCESS,FAILURE`.
Comma-separated list of source dataset names to filter by.
Comma-separated list of target dataset names to filter by.
ISO 8601 start of the time range. Defaults to 30 days ago.
ISO 8601 end of the time range. Defaults to now.
## Response
Paginated list of jobs.
List of comparison job objects.
Job ID.
UUID of the comparison.
Name of the comparison.
UUID of the result record, once available.
Job status. One of `PENDING`, `STARTED`, `SUCCESS`, `FAILURE`, `REVOKED`.
Source data source name.
Target data source name.
Source dataset name.
Target dataset name.
Source database type.
Target database type.
Celery task ID.
ISO 8601 creation timestamp.
ISO 8601 start timestamp.
ISO 8601 completion timestamp.
Execution duration in seconds.
Number of retries.
Status or error message.
Current page.
Page size.
Total number of jobs.
Total pages.
Includes available filter values for `status_filters`, `source_dataset_filters`, and `target_dataset_filters`.
```curl cURL theme={null}
curl -X GET "https://YOUR_BASE_URL/jobs/comparison?page=1&size=20&status_filters=FAILURE" \
-H "Authorization: Bearer " \
-H "Workspace-Id: "
```
```python Python theme={null}
import requests
url = "https://YOUR_BASE_URL/jobs/comparison"
headers = {
"Authorization": "Bearer ",
"Workspace-Id": "",
}
params = {
"page": 1,
"size": 20,
"status_filters": "FAILURE",
}
response = requests.get(url, headers=headers, params=params)
print(response.json())
```
```javascript JavaScript theme={null}
const response = await fetch(
"https://YOUR_BASE_URL/jobs/comparison?page=1&size=20&status_filters=FAILURE",
{
method: "GET",
headers: {
"Authorization": "Bearer ",
"Workspace-Id": "",
},
}
);
const data = await response.json();
console.log(data);
```
```json 200 theme={null}
{
"data": {
"items": [
{
"job_id": 1042,
"comparison_id": "eeeeeeee-0000-0000-0000-000000000005",
"comparison_name": "orders table comparison",
"comparison_result_id": "ffffffff-0000-0000-0000-000000000006",
"status": "SUCCESS",
"source_datasource_name": "prod-postgres",
"target_datasource_name": "prod-snowflake",
"source_dataset_name": "orders",
"target_dataset_name": "orders",
"source_datasource_type": "postgresql",
"target_datasource_type": "snowflake",
"task_id": "7f3a1b2c-4d5e-6f7a-8b9c-0d1e2f3a4b5c",
"created_at": "2025-01-15T10:00:00Z",
"started_at": "2025-01-15T10:00:02Z",
"date_done": "2025-01-15T10:01:45Z",
"time_taken": 103.2,
"retry_count": 0,
"message": ""
}
],
"page": 1,
"size": 20,
"total": 1,
"pages": 1
},
"meta": {
"status_filters": ["SUCCESS", "FAILURE", "PENDING"],
"source_dataset_filters": ["orders"],
"target_dataset_filters": ["orders"]
}
}
```