Skip to main content
GET
/
api
/
v1
/
workspaces
/
{id}
/
lists
List lists
curl --request GET \
  --url https://api.getarca.app/api/v1/workspaces/{id}/lists \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 20,
    "workspace_id": 3,
    "folder_id": 10,
    "name": "Backend",
    "icon": "code",
    "color": "blue",
    "position": 1,
    "created_at": "2026-01-15T08:00:00.000Z"
  },
  {
    "id": 21,
    "workspace_id": 3,
    "folder_id": 10,
    "name": "Frontend",
    "icon": "chart",
    "color": "green",
    "position": 2,
    "created_at": "2026-01-15T08:05:00.000Z"
  }
]
Requires the lists:read scope. You must be a member of the workspace. Access-restricted members only receive lists within their permitted folders or explicitly granted lists.

​
Path parameters

​
id
string
required
The numeric workspace ID.

​
Response

Returns an array of list objects.
​
id
number
required
List identifier.
​
workspace_id
number
required
ID of the workspace this list belongs to.
​
folder_id
number | null
ID of the parent folder. null if the list is not inside a folder.
​
name
string
required
List name.
​
icon
string | null
Icon identifier slug (e.g., "folder-1", "chart", "code"). null if not set.
​
color
string | null
List color.
​
position
number
required
Numeric sort position. Lists are ordered by this value ascending.
​
created_at
string
required
UTC ISO-8601 creation timestamp.
[
  {
    "id": 20,
    "workspace_id": 3,
    "folder_id": 10,
    "name": "Backend",
    "icon": "code",
    "color": "blue",
    "position": 1,
    "created_at": "2026-01-15T08:00:00.000Z"
  },
  {
    "id": 21,
    "workspace_id": 3,
    "folder_id": 10,
    "name": "Frontend",
    "icon": "chart",
    "color": "green",
    "position": 2,
    "created_at": "2026-01-15T08:05:00.000Z"
  }
]