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

# GET /projects

`GET /projects`

## Request

- Base URL: `https://api.focusbear.io` (the document declares no server; this is the origin it was published from)
- URL: `https://api.focusbear.io/projects`
- Auth: HTTP bearer

## Query parameters

- `order` 'ASC' | 'DESC'
- `page` number
- `take` number
- `search` string
- `status` 'active' | 'completed' | 'archived'
- `tag` string

## Response `200`

- GetProjectsResponseDto
  - `data` array[], required
    - unknown[]
      - unknown
  - `meta` PaginationMetaDto, required
    - `page` number, required
    - `take` number, required
    - `order` 'ASC' | 'DESC', required
    - `itemCount` number, required
    - `pageCount` number, required
    - `hasPreviousPage` boolean, required
    - `hasNextPage` boolean, required
  - `projects` ProjectResponseDto[], required: Deprecated alias for data
    - `id` string, required: For native projects: the project UUID. For synced (ClickUp) projects: the focus_mode_tags.id when a tag exists, otherwise the synced_projects.id. Use synced_project_id to reliably identify the synced project record regardless of tag presence. Not normalized to synced_project_id as mobile/web clients use this id for GET /projects/:id lookups and routing. A swap to synced_project_id requires a coordinated client release.
    - `name` string, required
    - `description` string
    - `owner_id` string, required
    - `custom_statuses` object[], required
    - `icon` string, nullable: One emoji character, or `null` when the project has no icon yet — which is what a clear returns, and what a project awaiting generation carries. This is the schema clients decode, so the nullability belongs here rather than only in the tests that assert it.
    - `members` ProjectMemberResponseDto[]
      - `id` string, required
      - `user_id` string
      - `email` string
      - `role` 'owner' | 'admin' | 'member', required
      - `invitation_status` 'pending' | 'accepted' | 'declined' | 'failed', required
      - `invitation_sent_at` string, date-time
      - `invitation_responded_at` string, date-time
      - `created_at` string, required
      - `updated_at` string, required
    - `task_count` number
    - `uncompleted_task_count` number
    - `synced_project_id` string
    - `synced_platform` string, nullable: Stored integration platform for synced projects; null when the legacy source is unknown. Read only.
    - `due_date` string, nullable
    - `importance` number
    - `outcome` number, nullable, required: Outcome significance on the 1..10 wire scale; null for unrated or synced projects.
    - `status` 'active' | 'completed' | 'archived', required: Lifecycle state: active (default), completed, or archived.
    - `top_priority_task` TopPriorityTaskDto
      - `id` string, required
      - `title` string, required
      - `top_score` number, nullable, required: Materialised TOP score. Null for todos not yet scored by the daily cron.
    - `metadata` object, nullable: Open per-project bag; `metadata.tags` holds the project's tags, lower-cased. Null when unset, and always null for synced projects, which have no row in `projects` to carry it.
    - `created_at` string, required
    - `updated_at` string, required
  - `total_count` number, required: Deprecated alias for meta.itemCount

---

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