---
title: "List Projects"
method: GET
path: "/api/companies/{company_uuid}/projects/"
tags: ["projects"]
---

# List Projects

`GET /api/companies/{company_uuid}/projects/`

## Request

- Base URL: `https://api.regdoor.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.regdoor.com/api/companies/{company_uuid}/projects/`
- Auth: HTTP bearer

## Path parameters

- `company_uuid` string, uuid, required

## Query parameters

- `status` 'active' | 'on_hold' | 'completed' | 'archived', nullable: Filter by a single status. Omit to return only active and on_hold projects. Pass completed or archived to list that status.
- `legal_entity_id` string[], nullable: Filter by legal entity UUID(s). Can specify multiple times. Returns projects linked to any of the given legal entities.
- `jurisdiction_id` integer[], nullable: Filter by jurisdiction (country) ID(s). Can specify multiple times. Returns projects linked to any of the given jurisdictions.
- `my` boolean, nullable: When true, only return projects owned by the current user.
- `group_uuid` string[], nullable: Filter by responsible area (group) UUID(s). Can specify multiple times. Returns projects linked to any of the given areas.
- `search` string, nullable: Case-insensitive match on the project title or description; every word must match.

## Headers

- `X-User-Email` string, nullable
- `X-User-Name` string, nullable
- `X-Teamspace-Uuid` string, uuid, nullable

## Response `200`

Successful Response

- ProjectListItem[]
  - `uuid` string, uuid4, required
  - `title` string, required
  - `description` string, nullable
  - `status` 'active' | 'on_hold' | 'completed' | 'archived', required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required
  - `owner` ProjectOwner, required
    - `uuid` string, uuid4, required
    - `name` string, required
  - `groups` ProjectGroupSummary[]
    - `uuid` string, uuid4, required
    - `name` string, required
  - `jurisdictions` ProjectJurisdictionRef[]
    - `id` integer, required
    - `name` string, required
    - `code` string, nullable
  - `legal_entities` ProjectLegalEntityRef[]
    - `uuid` string, uuid4, required
    - `legal_name` string, required
    - `tax_id` string, nullable
  - `entity_counts` EntityCounts
    - `contacts` integer
    - `organizations` integer
    - `interactions` integer
    - `private_docs` integer
    - `public_docs` integer
    - `events` integer
    - `tasks` integer
  - `markdown` string
  - `markdown_truncated` boolean
  - `visibility` 'company' | 'personal'
  - `personal_owner_user_uuid` string, uuid4, nullable

## Other responses

- `404`: Not found
- `422`: Validation Error

---

[API](https://skmtc.dev/regdoor/apis/regdoor-api.md) - [All operations](https://skmtc.dev/regdoor/apis/regdoor-api/llms.txt) - [OpenAPI document](https://skmtc.dev/regdoor/apis/regdoor-api/revisions/7642336631af?raw)