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

# bookmarks.list()

> List bookmarks in a repository.

List branch-like bookmark refs using cursor pagination.

**Required scope: `read`**

```ts theme={null}
const bookmarks = await mesa.bookmarks.list({ repo: 'app', limit: 50 });

for (const bookmark of bookmarks.bookmarks) {
  console.log(bookmark.name, bookmark.change_id);
}
```

## Options

<ParamField path="repo" type="string" required>
  Repository name.
</ParamField>

<ParamField path="org" type="string | undefined">
  Organization override.
</ParamField>

<ParamField path="cursor" type="string | undefined">
  Opaque pagination cursor from a previous response.
</ParamField>

<ParamField path="limit" type="number | undefined">
  Maximum number of bookmarks to return. The server maximum is `100`.
</ParamField>

## Response

<ResponseField name="next_cursor" type="string | null">
  Cursor for the next page, or null when no more results remain.
</ResponseField>

<ResponseField name="has_more" type="boolean">
  Whether another page of results is available.
</ResponseField>

<ResponseField name="bookmarks" type="Bookmark[]">
  Bookmark objects.
</ResponseField>

### Bookmark

<ResponseField name="name" type="string">
  Bookmark name.
</ResponseField>

<ResponseField name="change_id" type="string">
  Change ID the bookmark points to.
</ResponseField>

<ResponseField name="is_default" type="boolean">
  Whether this is the repository default bookmark.
</ResponseField>