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

# Projects

> List and retrieve projects with the SDK.

## list()

Returns all projects accessible to the authenticated token.

### Signature

```js theme={null}
royaltyport.projects.list()
```

### Example

```js theme={null}
import { Royaltyport } from '@royaltyport/sdk';

const royaltyport = new Royaltyport({
  apiKey: 'rp_your_token_here',
});

const { data: projects } = await royaltyport.projects.list();

for (const project of projects) {
  console.log(`${project.name} (${project.id})`);
}
```

<Note>
  A project-scoped token returns only its assigned project. An organization-scoped token returns all projects.
</Note>

***

## get()

Returns a single project by ID.

### Signature

```js theme={null}
royaltyport.projects.get(projectId)
```

### Parameters

| Parameter   | Type     | Required | Description    |
| ----------- | -------- | -------- | -------------- |
| `projectId` | `string` | Yes      | The project ID |

### Example

```js theme={null}
import { Royaltyport } from '@royaltyport/sdk';

const royaltyport = new Royaltyport({
  apiKey: 'rp_your_token_here',
});

const { data: project } = await royaltyport.projects.get('a1b2c3d4-e5f6-7890-abcd-ef1234567890');

console.log(project.name);       // "Record Label Ltd"
console.log(project.created_at); // "2025-01-15T12:00:00Z"
```
