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

# Retrieve Project

> Retrieve a project or projects

This guide explains how to retrieve an existing project or projects using the BlendDuck SDK.

## Usage

To retrieve a project, you'll use the `projects.get()` method of the BlendDuck client.

```typescript
import BlendDuck from "@blendduck/node-sdk";

// Initialize the BlendDuck client
const client = new BlendDuck({
  apiKey: process.env.BLENDDUCK_API_KEY
});

async function retrieveProject(projectId: string) {
  // Retrieve the project
  const project = await client.projects.get(projectId);

  console.log(`Retrieved project: ${project.title}`);
  console.log(`Number of clips: ${project.clips.length}`);

  // You can now work with the project object
  // For example, you can access its properties:
  console.log(`Project aspect ratio: ${project.ratio}`);
  console.log(`Project theme: `, project.theme);
}

// Usage
retrieveProject("your-project-id-here");
```

To retrieve projects, you'll use the `projects.list()` method

```ts
import BlendDuck from "@blendduck/node-sdk";

// Initialize the BlendDuck client
const client = new BlendDuck({
  apiKey: process.env.BLENDDUCK_API_KEY
});

async function retrieveProjects() {
  const { projects } = await client.projects.list();
  // equals
  // const { projects } = await client.projects.list({ page: 0, limit: 20 });
}

// Usage
retrieveProjects();
```

## Error Handling

If the project cannot be found or there's an issue with the API request, the method will throw an error. It's good practice to wrap the call in a try-catch block to handle any potential errors gracefully.

## Related Features

* [Create Project](/features/create-project)
* [Update Project](/features/update-project)
* [Delete Project](/features/delete-project)