Get List Statuses

GET 
/projects/lists/:listId/statuses

Returns the effective status groups for a list — the same set as the owning space, resolved server-side. Prefer this over walking parentId up to the space.

Request

Version stringrequired

API Version

Available optionsv3

listId stringrequired

List id

locationId string

Location id. Required for channel: APP. Ignored for OAuth/PIT — those use the location on the auth token. Do not send in path, body, or headers.

application/json

Successful response

application/json

Schema

Schema

groupsobject[]required

Status groups with nested statuses (key, label, color, position)

Example (auto)

{
  "groups": [
    {
      "key": "todo",
      "label": "To Do",
      "color": "#E2E8F0",
      "position": 0,
      "statuses": [
        {
          "key": "to_do",
          "label": "To Do",
          "color": "#94A3B8",
          "position": 0
        }
      ]
    },
    {
      "key": "done",
      "label": "Done",
      "color": "#BBF7D0",
      "position": 2,
      "statuses": [
        {
          "key": "completed",
          "label": "Completed",
          "color": "#22C55E",
          "position": 0
        }
      ]
    }
  ]
}