---
title: "List all libraries you have access to."
method: GET
path: "/v1/libraries"
tags: ["beta.libraries"]
---

# List all libraries you have access to.

`GET /v1/libraries`

List all libraries that you have created or have been shared with you.

## Query parameters

- `page_size` integer
- `page_token` string, nullable — Continuation token from a previous response's next_page_token. Preferred over `page`.
- `page` integer — Deprecated: use page_token. Offset paging re-scans earlier pages and is being phased out.
- `search` string, nullable — Case-insensitive search on the library name.
- `filter_owned_by_me` boolean, nullable — Deprecated: this parameter will be removed in a future version.

## Response `200`

Successful Response

- ListLibrariesResponse
  - `pagination` PaginationInfo
    - `total_items` integer, required
    - `total_pages` integer, required
    - `current_page` integer, required
    - `page_size` integer, required
    - `has_more` boolean, required
  - `data` Library[], required
    - `id` string, uuid, required
    - `name` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
    - `owner_id` string, uuid, nullable, required
    - `owner_type` string, required
    - `total_size` integer, required
    - `nb_documents` integer, required
    - `chunk_size` integer, nullable, required
    - `emoji` string, nullable
    - `description` string, nullable
    - `generated_description` string, nullable
    - `explicit_user_members_count` integer, nullable
    - `explicit_workspace_members_count` integer, nullable
    - `org_sharing_role` string, nullable
    - `generated_name` string, nullable — Generated Name
  - `next_page_token` string, nullable — Opaque continuation token for the next page. Pass it back as `page_token` to fetch the next page. Null when there are no more results. Prefer this over the deprecated offset `page` parameter.

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.net/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/versions/933c4ebdcd72/schema)