> ## Documentation Index
> Fetch the complete documentation index at: https://docs.babou.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get Project

> Retrieve details about a specific project

## Overview

Get detailed information about a specific video project by its ID.

## Request

### Path Parameters

<ParamField path="projectId" type="string" required>
  The project ID (e.g., `prj_abc123xyz`)
</ParamField>

### Headers

<ParamField header="Authorization" type="string" required>
  Bearer token with your API key
</ParamField>

## Response

Returns the complete project object with all metadata.

## Examples

<CodeGroup>
  ```bash curl theme={null}
  curl https://api.babou.ai/api/v1/projects/prj_abc123xyz \
    -H "Authorization: Bearer $BABOU_API_KEY"
  ```

  ```typescript TypeScript theme={null}
  async function getProject(projectId: string) {
    const response = await fetch(
      `https://api.babou.ai/api/v1/projects/${projectId}`,
      {
        headers: {
          'Authorization': `Bearer ${process.env.BABOU_API_KEY}`
        }
      }
    );

    return await response.json();
  }

  const project = await getProject('prj_abc123xyz');
  console.log(`Project: ${project.name}`);
  ```

  ```python Python theme={null}
  import os
  import requests

  def get_project(project_id):
      response = requests.get(
          f'https://api.babou.ai/api/v1/projects/{project_id}',
          headers={'Authorization': f'Bearer {os.environ["BABOU_API_KEY"]}'}
      )
      return response.json()

  project = get_project('prj_abc123xyz')
  print(f'Project: {project["name"]}')
  ```
</CodeGroup>

## Response Example

```json theme={null}
{
  "id": "prj_abc123xyz",
  "name": "Product Launch Video",
  "description": "Marketing video for Q4 2025",
  "settings": null,
  "active_export_id": null,
  "created_at": "2025-12-02T10:00:00Z"
}
```

## Error Responses

<ResponseField name="NOT_FOUND" type="404">
  Project not found or you don't have access

  ```json theme={null}
  {
    "error": "Project not found",
    "code": "NOT_FOUND"
  }
  ```
</ResponseField>

## Next Steps

<CardGroup cols={2}>
  <Card title="List Chapters" icon="list" href="/api-reference/chapters/list">
    View chapters in this project
  </Card>

  <Card title="Export Project" icon="file-export" href="/api-reference/exports/start">
    Export project to video
  </Card>
</CardGroup>