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

# Get project

`GET /v1/projects/{project_id}`

## Path parameters

- `project_id` string, required

## Response `200`

Successful Response

- AvatarProjectItem
  - `id` string, nullable
  - `createdAt` string, date-time, nullable
  - `username` string, nullable
  - `videoUrl` string, nullable
  - `avatarImageUrl` string, nullable
  - `aspectRatio` '1:1' | '16:9' | '9:16', required
  - `text` string, nullable
  - `voiceId` string, nullable
  - `voiceUrl` string, nullable
  - `userId` string, nullable
  - `jobType` string, nullable
  - `status` string, nullable
  - `stage` string, nullable
  - `progress` number, nullable
  - `errorMessage` string, nullable
  - `audioSource` string, nullable
  - `avatarImageInput` object, nullable
  - `shared` boolean

## Other responses

- `422` — Validation Error

---

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