---
title: "[Preview] List projects"
method: GET
path: "/companies/{companyId}/projects"
tags: ["projects"]
---

# \[Preview\] List projects

`GET /companies/{companyId}/projects`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/companies/{companyId}/projects`
- Auth: HTTP bearer

Retrieve all projects for the company. Use the query parameters to filter and navigate through the results.

A project enriches a dimension 6 (Project) tag value with business semantics
such as name, project number, customer and status.

The company must have the Tags feature enabled in their price plan.

**Preview:** This endpoint is in preview and may change or be removed before general availability.
[Read the full preview policy](/reference/versioning#preview)

**Scope:** `projects:read`

## Query parameters

- `page` integer
- `pageSize` integer
- `query` string

## Response `200`

Projects found

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` Project[]
    - `id` string, uuid, required: Unique identifier of the project
    - `name` string, required: Name of the project
    - `projectNumber` string, required: The project number, unique per company. Used as the dimension 6 tag value.
    - `status` 'active' | 'archived', required: The lifecycle status of the project
    - `startDate` string, date, nullable: The date the project starts (yyyy-MM-dd)
    - `endDate` string, date, nullable: The date the project ends (yyyy-MM-dd)
    - `customerRef` CustomerRef, nullable: Reference to a customer
      - `id` string, uuid: Unique identifier of the customer
      - `name` string: Name of the customer
      - `customerNumber` string: Customer number of the referenced customer
    - `tagRef` ProjectTagRef, required
      - `id` string, uuid: Unique identifier of the tag value
      - `name` string: The tag value (the project number)

## Other responses

- `403`: Forbidden. The company's price plan does not include API access, or the integration does not have the required scope. See [price plan requirements](price-plan-requirements#handling-403-responses) for details on how to handle this response.

## Changes

- **2026-11-03** `9395020f3da2`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/bokio/apis/company-api/changes/companies/:companyId/projects/get.md)

---

[API](https://skmtc.dev/bokio/apis/company-api.md) - [All operations](https://skmtc.dev/bokio/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/company-api/revisions/9395020f3da2?raw)