---
title: "Get project"
method: GET
path: "/v2/teams/{team_id}/projects/{project_id}"
tags: ["v2", "Projects"]
---

# Get project

`GET /v2/teams/{team_id}/projects/{project_id}`

## Path parameters

- `team_id` union, required
  - string, uuid
  - string
- `project_id` union, required
  - string, uuid
  - string

## Response `200`

Success

- ProjectWithCounts — Project with doc and thread counts for list view.
  - `id` union — Project ID
    - string, uuid
    - string
  - `team_id` union, required — Team ID
    - string, uuid
    - string
  - `name` string, required — Project name
  - `description` string, nullable — Optional description
  - `created_by` union, required — User ID who created the project
    - string, uuid
    - string
  - `created_at` string, date-time — Project created at
  - `updated_at` string, date-time — Project updated at
  - `is_archived` boolean — Grave marker for soft deletion
  - `team_wide_permission` 'read' | 'write', nullable — If set, all team members get this permission on docs in the project
  - `doc_count` integer — Number of docs in project
  - `thread_count` integer — Number of threads in project

## Other responses

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

---

[API](https://skmtc.dev/definite/apis/defapi.md) · [All operations](https://skmtc.dev/definite/apis/defapi/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/definite/defapi/revisions/5ea378187147/schema)