---
title: "Get a project"
method: GET
path: "/api/projects/{id}"
---

# Get a project

`GET /api/projects/{id}`

## Request

- Base URL: `https://taskhold.com`
- URL: `https://taskhold.com/api/projects/{id}`
- Auth: HTTP bearer

One project.

## Response `200`

OK

- object
  - `project` Project
    - `id` string, uuid
    - `name` string
    - `description` string, nullable
    - `color` string
    - `is_active` boolean
    - `created_at` string, date-time

## Other responses

- `401`: Missing, malformed or unknown API key. `reason` is one of missing_key, bad_header, not_a_taskhold_key, unknown_key; `message` says what to do and `url` links to Settings.
- `402`: The key is valid but the account has no active subscription. `url` links to Billing.
- `404`: Project not found
- `500`: Server error

---

[API](https://skmtc.dev/taskhold/apis/taskhold-api.md) · [All operations](https://skmtc.dev/taskhold/apis/taskhold-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taskhold/apis/taskhold-api/revisions/496ae75d7cdd?raw)