---
title: "Your shelves: proj_0 (All Projects) and one per project, with item counts."
method: GET
path: "/v1/shelves"
---

# Your shelves: proj_0 (All Projects) and one per project, with item counts.

`GET /v1/shelves`

## Request

- Base URL: `https://api.lumeta.ai`
- URL: `https://api.lumeta.ai/v1/shelves`
- Auth: HTTP bearer

## Response `200`

OK

- object
  - `data` Shelf[]
    - `project` string
    - `name` string
    - `role` string
    - `item_count` integer
    - `items_url` string
  - `next_cursor` string, nullable

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/lumeta/apis/lumeta-api.md) · [All operations](https://skmtc.dev/lumeta/apis/lumeta-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumeta/apis/lumeta-api/revisions/1f3b5e5b87f6?raw)