List tasks - Arca Documentation

GET

api

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
}

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

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.

Show Task object fields

number

required

Task identifier.

workspace_id

number

required

Workspace this task belongs to.

list_id

number | null

List this task belongs to. null if the task is not in a list.

title

string

required

Task title.

priority

string

required

Task priority. One of urgent, high, medium, low, or none.

identifier

number

required

Workspace-scoped sequential task number (e.g., 1, 2, 3).

due_date

string | null

UTC ISO-8601 due date. null if not set.

start_date

string | null

UTC ISO-8601 start date. null if not set.

creator_id

number

required

User ID of the person who created the task.

created_at

string

required

UTC ISO-8601 creation timestamp.

status

object | null

Current task status. null if no status is assigned.

Show Status fields

number

required

Status identifier.

name

string

required

Status label (e.g., "In Progress").

icon

string | null

Icon associated with the status.

color

string | null

Color associated with the status.

category

string

required

Status category. One of pending, in_progress, completed, or cancelled.

assignees

array

required

Array of users assigned to the task. Empty array if unassigned.

Show Assignee fields

number

required

User ID.

name

string

required

Display name.

avatar_url

string | null

Profile picture URL.

subtasks

array

required

Direct subtasks of this task. Empty array if none.

Show Subtask fields

number

required

Subtask identifier.

title

string

required

Subtask title.

priority

string

required

Subtask priority.

identifier

number

required

Workspace-scoped sequential task number.

status

object | null

Current status of the subtask. Same shape as the parent task status.

assignees

array

required

Users assigned to the subtask. Same shape as the parent task assignees.

custom_fields

array

required

Custom fields that apply to each task’s list, each with its current value. Fields restricted to other lists or folders are not returned.

Show Custom field entry

number

required

Custom field identifier.

name

string

required

Custom field name (e.g., "Customer Tier").

type

string

required

Field type. One of text, number, date, checkbox, rating, dropdown, money, or people.

config

object | null

Type-specific configuration.For example:

rating fields include icon and color;
dropdown fields include an options array of strings;
money fields include currency and decimals.

It’s null for field types with no configuration (which are text, number, date, checkbox and people).

position

number

required

Sort position of the field within the workspace.

value

string | null

The task’s value for this field. null when no value has been set.

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
}

Get taskReturns a single task with full details including its status, assignees, labels, and attachments.

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
}

​Path parameters

​Query parameters

​Response

Path parameters

Query parameters

Response