Skip to main content
GET
/
api
/
v1
/
workspaces
/
{id}
/
statuses
List statuses
curl --request GET \
  --url https://api.getarca.app/api/v1/workspaces/{id}/statuses \
  --header 'Authorization: Bearer <token>'
[
  {
    "id": 1,
    "workspace_id": 3,
    "name": "Backlog",
    "icon": null,
    "color": "gray",
    "category": "pending",
    "position": 1,
    "created_at": "2026-01-01T00:00:00.000Z"
  },
  {
    "id": 2,
    "workspace_id": 3,
    "name": "In Progress",
    "icon": "in-progress",
    "color": "blue",
    "category": "active",
    "position": 2,
    "created_at": "2026-01-01T00:00:00.000Z"
  },
  {
    "id": 3,
    "workspace_id": 3,
    "name": "Done",
    "icon": "check",
    "color": "green",
    "category": "completed",
    "position": 3,
    "created_at": "2026-01-01T00:00:00.000Z"
  }
]
Requires the workspaces:read scope. You must be a member of the workspace.

​
Path parameters

​
id
string
required
The numeric workspace ID.

​
Response

Returns an array of status objects ordered by position ascending.
​
id
number
required
Status identifier.
​
workspace_id
number
required
Workspace this status belongs to.
​
name
string
required
Status label (e.g., "In Progress", "Done").
​
icon
string | null
Icon slug associated with the status.
​
color
string | null
Color value associated with the status.
​
category
string
required
Status category. One of pending, active, done, completed, or cancelled.
​
position
number
required
Sort position (ascending order).
​
created_at
string
required
UTC ISO-8601 creation timestamp.
[
  {
    "id": 1,
    "workspace_id": 3,
    "name": "Backlog",
    "icon": null,
    "color": "gray",
    "category": "pending",
    "position": 1,
    "created_at": "2026-01-01T00:00:00.000Z"
  },
  {
    "id": 2,
    "workspace_id": 3,
    "name": "In Progress",
    "icon": "in-progress",
    "color": "blue",
    "category": "active",
    "position": 2,
    "created_at": "2026-01-01T00:00:00.000Z"
  },
  {
    "id": 3,
    "workspace_id": 3,
    "name": "Done",
    "icon": "check",
    "color": "green",
    "category": "completed",
    "position": 3,
    "created_at": "2026-01-01T00:00:00.000Z"
  }
]