---
title: "Find a project by ID"
method: GET
path: "/v1/workspaces/{workspaceId}/projects/{projectId}"
tags: ["Project"]
---

# Find a project by ID

`GET /v1/workspaces/{workspaceId}/projects/{projectId}`

## Path parameters

- `workspaceId` string, required — Represents a workspace identifier across the system.
- `projectId` string, required — Represents a project identifier across the system.

## Query parameters

- `hydrated` boolean — If set to true, results will contain additional information about the project
- `custom-field-entity-type` string
- `expense-limit` integer — Represents the maximum number of expenses to fetch.
- `expense-date` string — If provided, you will get expenses dated before the provided value in yyyy-MM-dd format.

## Response `200`

OK

- ProjectDtoV1
  - `archived` boolean — Indicates whether project is archived or not.
  - `billable` boolean — Indicates whether project is billable or not.
  - `budgetEstimate` EstimateWithOptionsDto — Represents a project budget estimate object.
    - `active` boolean
    - `estimate` integer — Represents an estimate as long.
    - `includeExpenses` boolean — Indicates whether estimate includes non-billable or not.
    - `resetOption` 'WEEKLY' | 'MONTHLY' | 'YEARLY' — Represents a reset option enum.
    - `type` 'AUTO' | 'MANUAL' — Represents an estimate type enum.
  - `color` string — Color format ^#(?:[0-9a-fA-F]{6}){1}$. Explanation: A valid color code should start with '#' and consist of six hexadecimal characters, representing a color in hexadecimal format. Color value is in standard RGB hexadecimal format.
  - `costRate` RateDtoV1 — Represents cost rate object.
    - `amount` integer — Represents an amount as integer.
    - `currency` string — Represents a currency.
  - `duration` string — Represents project duration in milliseconds.
  - `estimate` EstimateDtoV1 — Represents a project estimate object.
    - `estimate` string — Represents a task duration estimate.
    - `type` 'AUTO' | 'MANUAL' — Represents an estimate type enum.
  - `hourlyRate` RateDtoV1 — Represents cost rate object.
    - `amount` integer — Represents an amount as integer.
    - `currency` string — Represents a currency.
  - `id` string — Represents project identifier across the system.
  - `memberships` MembershipDtoV1[] — Represents a list of membership objects.
    - `costRate` RateDtoV1 — Represents cost rate object.
      - `amount` integer — Represents an amount as integer.
      - `currency` string — Represents a currency.
    - `hourlyRate` HourlyRateDtoV1 — Represents an hourly rate object.
      - `amount` integer — Represents an amount as integer.
      - `currency` string — Represents a currency.
    - `membershipStatus` 'PENDING' | 'ACTIVE' | 'DECLINED' | 'INACTIVE' | 'ALL' — Represents a membership status enum.
    - `membershipType` 'WORKSPACE' | 'PROJECT' | 'USERGROUP' — Represents membership type enum.
    - `targetId` string — Represents target identifier across the system.
    - `userId` string — Represents user identifier across the system.
  - `name` string — Represents a project name.
  - `note` string — Represents project note.
  - `public` boolean — Indicates whether project is public or not.
  - `template` boolean — Indicates whether project is a template or not.
  - `timeEstimate` TimeEstimateDto — Represents a project time estimate object.
    - `active` boolean
    - `estimate` string — Represents project duration in milliseconds.
    - `includeNonBillable` boolean
    - `resetOption` 'WEEKLY' | 'MONTHLY' | 'YEARLY' — Represents a reset option enum.
    - `type` 'AUTO' | 'MANUAL' — Represents an estimate type enum.
  - `workspaceId` string — Represents workspace identifier across the system.

## Changes

- **2026-08-20** `a5b636acbcd8` — 1 breaking, 21 info
  - for the `query` request parameter `expense-date`, default value `` was added
  - the `color` response's property default value `` was added for the status `200`
  - the `currency` response's property default value `` was added for the status `200`
  - the `currency` response's property default value `` was added for the status `200`
  - …18 more

[Change history](https://skmtc.dev/clockify/apis/clockify-api/changes/v1/workspaces/:workspaceId/projects/:projectId/get.md)

---

[API](https://skmtc.dev/clockify/apis/clockify-api.md) · [All operations](https://skmtc.dev/clockify/apis/clockify-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/clockify/clockify-api/revisions/a5b636acbcd8/schema)