---
title: "Get project"
method: GET
path: "/v1/projects/{project_id}"
tags: ["Projects"]
---

# Get project

`GET /v1/projects/{project_id}`

Retrieve a single project by its unique identifier. Returns the project's metadata including title, author, creation date, and folder location.

Use this endpoint to fetch details about a specific project, for example to display project information or verify a project exists before creating content within it.

> 🚧 Permissions
>
> Please check you have the relevant permissions required to access this resource. This may include specific permissions on the object itself or its parent, or having the correct user role if you're making updates.

## Path parameters

- `project_id` string, required

## Response `200`

200

- object
  - `data` object, required
    - `id` string, required
    - `url` string — The URL of this resource in the Dovetail web app. This field is experimental and may change without notice.
    - `author` object, nullable, required
      - `id` string, required
      - `name` string, nullable, required
    - `title` string, required
    - `type` 'project', required
    - `created_at` string, required
    - `deleted` boolean, required
    - `folder` object, nullable, required
      - `id` string, required

## Other responses

- `400` — 400
- `401` — 401
- `403` — 403
- `404` — 404
- `422` — 422
- `429` — 429
- `500` — 500

---

[API](https://skmtc.net/dovetail/apis/dovetail-public-api.md) · [All operations](https://skmtc.net/dovetail/apis/dovetail-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/dovetail/dovetail-public-api/versions/4107f5fdf8b2/schema)