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": "in_progress"
      },
      "assignees": [
        {
          "id": 7,
          "name": "Bob",
          "avatar_url": "https://cdn.example.com/avatars/bob.png"
        }
      ],
      "subtasks": [
        {
          "id": 102,
          "title": "Write unit tests",
          "priority": "medium",
          "identifier": 6,
          "status": {
            "id": 1,
            "name": "Backlog",
            "icon": null,
            "color": "gray",
            "category": "pending"
          },
          "assignees": []
        }
      ],
      "custom_fields": [
        {
          "id": 1,
          "name": "Customer Tier",
          "type": "dropdown",
          "config": { "options": ["Free", "Starter", "Pro"] },
          "position": 1,
          "value": "Pro"
        }
      ]
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "total_pages": 1
}

Documentation Index

Fetch the complete documentation index at: https://docs.getarca.app/llms.txt

Use this file to discover all available pages before exploring further.

Requires the tasks:read scope. You must be a member of the workspace. Access-restricted members only receive tasks in their permitted lists. Passing a list_id for an inaccessible list returns 403.
This endpoint returns top-level tasks only. Each task includes its direct subtasks inline in the subtasks array.

​
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": "in_progress"
      },
      "assignees": [
        {
          "id": 7,
          "name": "Bob",
          "avatar_url": "https://cdn.example.com/avatars/bob.png"
        }
      ],
      "subtasks": [
        {
          "id": 102,
          "title": "Write unit tests",
          "priority": "medium",
          "identifier": 6,
          "status": {
            "id": 1,
            "name": "Backlog",
            "icon": null,
            "color": "gray",
            "category": "pending"
          },
          "assignees": []
        }
      ],
      "custom_fields": [
        {
          "id": 1,
          "name": "Customer Tier",
          "type": "dropdown",
          "config": { "options": ["Free", "Starter", "Pro"] },
          "position": 1,
          "value": "Pro"
        }
      ]
    }
  ],
  "page": 1,
  "limit": 20,
  "total": 1,
  "total_pages": 1
}