---
title: "List sync tasks"
method: GET
path: "/api/{workspaceId}/sources/tasks"
tags: ["Syncs"]
---

# List sync tasks

`GET /api/{workspaceId}/sources/tasks`

## Request

- Base URL: `https://use.jitsu.com`
- URL: `https://use.jitsu.com/api/{workspaceId}/sources/tasks`
- Auth: HTTP bearer

Returns up to 50 most recent tasks for a sync, ordered by start time descending. Filter with `taskId` (single task — response carries `task` and `logs` URL), `status`, and a `from`/`to` time window. Without `taskId` the response carries the `tasks` array.

## Path parameters

- `workspaceId` string, required

## Query parameters

- `syncId` string
- `taskId` string
- `from` string, nullable
- `to` string, nullable
- `status` string

## Response `200`

OK

- object
  - `ok` boolean, required
  - `error` string
  - `tasks` object[]
    - `sync_id` string, required
    - `task_id` string, required
    - `package` string, required
    - `version` string, required
    - `started_at` string, nullable, required
    - `updated_at` string, nullable, required
    - `status` string, required
    - `description` string, nullable
    - `metrics` unknown
    - `error` string, nullable
    - `started_by` unknown
  - `task` object
    - `sync_id` string, required
    - `task_id` string, required
    - `package` string, required
    - `version` string, required
    - `started_at` string, nullable, required
    - `updated_at` string, nullable, required
    - `status` string, required
    - `description` string, nullable
    - `metrics` unknown
    - `error` string, nullable
    - `started_by` unknown
  - `logs` string

## Other responses

- `400`: Bad request
- `401`: Authorization required
- `403`: Forbidden — no access to this workspace, or the workspace's plan does not include this feature
- `500`: Internal server error

---

[API](https://skmtc.dev/jitsu/apis/jitsu-api.md) - [All operations](https://skmtc.dev/jitsu/apis/jitsu-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jitsu/apis/jitsu-api/revisions/f6b8702d246f?raw)