---
title: "List Columns"
method: GET
path: "/api_v2/projects/{project_id}/columns.json"
tags: ["Columns"]
---

# List Columns

`GET /api_v2/projects/{project_id}/columns.json`

## Request

- Base URL: `https://www.bugherd.com`
- URL: `https://www.bugherd.com/api_v2/projects/{project_id}/columns.json`
- Auth: HTTP basic

Returns all kanban columns for a project. Includes both built-in columns (backlog, todo, doing, done) and any custom columns.

> **Known issue:** The `tasks_count` field may return incorrect values (including negative numbers) for some columns.

## Path parameters

- `project_id` integer, required

## Response `200`

List of columns

- object
  - `columns` Column[]
    - `id` integer
    - `name` string
    - `project_id` integer
    - `position` integer: Display order (0-indexed)
    - `tasks_count` integer
    - `created_at` string, date-time
    - `updated_at` string, date-time

---

[API](https://skmtc.dev/bugherd/apis/bugherd-api-v2.md) · [All operations](https://skmtc.dev/bugherd/apis/bugherd-api-v2/llms.txt) · [OpenAPI document](https://skmtc.dev/bugherd/apis/bugherd-api-v2/revisions/bf473cda70d4?raw)