Skip to main content
GET
/
api
/
v1
/
workspaces
/
{id}
/
tasks
List tasks
curl --request GET \
  --url https://api.getarca.app/api/v1/workspaces/{id}/tasks \
  --header 'Authorization: Bearer <token>'
{
  "data": [
    {
      "id": 101,
      "workspace_id": 3,
      "list_id": 20,
      "title": "Set up CI pipeline",
      "priority": "high",
      "identifier": 5,
      "due_date": "2026-03-25T00:00:00.000Z",
      "start_date": null,
      "creator_id": 1,
      "created_at": "2026-03-10T14:22:00.000Z",
      "status": {
        "id": 2,
        "name": "In Progress",
        "icon": "in-progress",
        "color": "blue",
        "category": "active"
      },
      "assignees": [
        {
          "id": 7,
          "name": "Bob",
          "avatar_url": "https://cdn.example.com/avatars/bob.png"
        }
      ]
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "total_pages": 1
}
Requires the tasks:read scope. You must be a member of the workspace.
This endpoint returns top-level tasks only. Subtasks are excluded from the results.

​
Path parameters

​
id
string
required
The numeric workspace ID.

​
Query parameters

​
list_id
string
Filter results to a specific list. If omitted, tasks from all lists are returned.
​
page
number
default:"1"
Page number (1-based).
​
limit
number
default:"50"
Number of tasks per page. Minimum 1, maximum 100.

​
Response

​
data
array
required
Array of task objects.
​
page
number
required
Current page number.
​
limit
number
required
Number of tasks per page used for this response.
​
total
number
required
Total number of matching tasks across all pages.
​
total_pages
number
required
Total number of pages.
{
  "data": [
    {
      "id": 101,
      "workspace_id": 3,
      "list_id": 20,
      "title": "Set up CI pipeline",
      "priority": "high",
      "identifier": 5,
      "due_date": "2026-03-25T00:00:00.000Z",
      "start_date": null,
      "creator_id": 1,
      "created_at": "2026-03-10T14:22:00.000Z",
      "status": {
        "id": 2,
        "name": "In Progress",
        "icon": "in-progress",
        "color": "blue",
        "category": "active"
      },
      "assignees": [
        {
          "id": 7,
          "name": "Bob",
          "avatar_url": "https://cdn.example.com/avatars/bob.png"
        }
      ]
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "total_pages": 1
}