---
title: "List binders owned by the account"
method: GET
path: "/me/binders"
---

# List binders owned by the account

`GET /me/binders`

## Request

- Base URL: `https://lucid.page`
- URL: `https://lucid.page/me/binders`
- Auth: one of:
  - HTTP bearer
  - API key in query parameter `apiKey`
  - none

Most recently updated first. Not paginated: an account holds at most 100 binders.

## Query parameters

- `doc` string

## Response `200`

The account's binders

- BinderList
  - `binders` BinderSummary[], required
    - `slug` string, required: Derived from the title at creation; never changes
    - `title` string, required
    - `description` string, required
    - `visibility` 'private' | 'unlisted' | 'public', required
    - `url` string, required: The binder page, https://lucid.page/b/{slug}. It 404s while the binder is private.
    - `item_count` integer, required
    - `version` integer, required: Bumped by every change; send it back as expected_version
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `doc_item_id` string, nullable: Only when listing with ?doc=: the id of the item holding that page, or null

## Other responses

- `400`: doc is not a valid page slug
- `401`: Authentication required

---

[API](https://skmtc.dev/lucid/apis/lucid-page.md) · [All operations](https://skmtc.dev/lucid/apis/lucid-page/llms.txt) · [OpenAPI document](https://skmtc.dev/lucid/apis/lucid-page/revisions/ac6b8c27c38b?raw)