---
title: "List projects"
method: GET
path: "/company/projects"
tags: ["Configuration"]
---

# List projects

`GET /company/projects`

## Request

- Base URL: `https://api.altera.co`
- URL: `https://api.altera.co/company/projects`
- Auth: API key in header `Authorization`

List projects belonging to the company identified by the Authorization API key. Returns active and disabled projects by default. Use onlyActive=1 to return only active projects. Find the desired project by name in data and pass its complete object as project when saving a sales invoice; tagId is the project identifier. No companyId parameter is needed.

## Query parameters

- `onlyActive` 0 | 1

## Response `200`

Company projects. data is an empty array when no projects match.

- object
  - `result` 'OK', required
  - `data` InvoiceTag[], required
    - `tagId` integer
    - `name` string
    - `enabled` boolean
    - `color` integer

## Other responses

- `401`: KEY_EXPIRED: a verified API key has expired. This requires that the company still has OpenAPI access. Unknown/invalid keys can receive the gateway 403.

## Changes

- **2026-10-12** `45544bcb4e8a`: 1 info
  - added the non-success response with the status `401`
- **2026-09-15** `06d306d0f00f`: 1 info
  - endpoint added

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

---

[API](https://skmtc.dev/altera-co/apis/altera-api.md) - [All operations](https://skmtc.dev/altera-co/apis/altera-api/llms.txt) - [OpenAPI document](https://skmtc.dev/altera-co/apis/altera-api/revisions/45544bcb4e8a?raw)