List the columns of a board

GET

/boards/{board}/columns

const url = 'https://projects.work.optidata.cloud/api/boards/1/columns';
const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};

try {
  const response = await fetch(url, options);
  const data = await response.json();
  console.log(data);
} catch (error) {
  console.error(error);
}

curl --request GET \
  --url https://projects.work.optidata.cloud/api/boards/1/columns \
  --header 'Authorization: Bearer <token>'

Returns the board’s active (non-archived) columns ordered by position.

Authorizations

bearerAuth

Parameters

Path Parameters

board

required

integer

Board id.

Responses

200

Columns.

application/json

Array<object>

A task list within a board.

object

integer

board_id

integer

name

string

<= 80 characters

description

string | null

<= 300 characters

icon

string | null

<= 255 characters

color

Column accent color (fixed palette).

string | null

Allowed values: #ef4444 #f97316 #f59e0b #84cc16 #10b981 #06b6d4 #3b82f6 #8b5cf6 #ec4899 #64748b

order

Position within the board.

integer

sort_order

Sticky automatic card sort applied to this column, when set.

string | null

archived_at

string | null format: date-time

created_at

string format: date-time

updated_at

string format: date-time

deleted_at

string | null format: date-time

Example

[
  {
    "id": 301,
    "board_id": 42,
    "name": "To do",
    "description": "",
    "icon": null,
    "order": 1,
    "sort_order": null,
    "color": null,
    "archived_at": null,
    "created_at": "2026-03-10T17:09:05.000000Z",
    "updated_at": "2026-03-10T17:09:05.000000Z",
    "deleted_at": null
  },
  {
    "id": 302,
    "board_id": 42,
    "name": "Doing",
    "description": "",
    "icon": null,
    "order": 2,
    "sort_order": null,
    "color": "#3b82f6",
    "archived_at": null,
    "created_at": "2026-03-10T17:09:05.000000Z",
    "updated_at": "2026-03-10T17:09:05.000000Z",
    "deleted_at": null
  }
]

401

Missing, invalid or expired bearer passport.

application/json

object

error

string

Example

{
  "error": "JWT passport exception: Missing bearer token in request"
}

403

The authenticated user lacks the required board permission.

application/json

object

message

string

Example

{
  "message": "This action is unauthorized."
}

404

Resource not found, or a nested resource does not belong to its parent in the path.

application/json

object

message

string

Example

{
  "message": "Not found."
}