---
title: "[Preview] Get a project"
method: GET
path: "/companies/{companyId}/projects/{projectId}"
tags: ["projects"]
---

# \[Preview\] Get a project

`GET /companies/{companyId}/projects/{projectId}`

## Request

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

Retrieve a specific project by its ID.

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`

## Response `200`

Project found

- 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.
- `404`: Project not found

## Changes

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

[Operation history](https://skmtc.dev/bokio/apis/company-api/changes/companies/:companyId/projects/:projectId/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)