---
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

## Changes

> 3 revisions in range; 1 could not be searched.

- **2026-07-26** `933c4ebdcd72` — 7 breaking, 5 info
  - the response property `pagination` became optional for the status `200`
  - the `pagination` response's property type/format changed from `object`/`` to ``/`` for status `200`
  - removed the required property `pagination/current_page` from the response with the `200` status
  - removed the required property `pagination/has_more` from the response with the `200` status
  - …8 more

[Change history](https://skmtc.dev/mistral/apis/mistral-ai-api/changes/v1/libraries/get.md)

---

[API](https://skmtc.dev/mistral/apis/mistral-ai-api.md) · [All operations](https://skmtc.dev/mistral/apis/mistral-ai-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/mistral/mistral-ai-api/revisions/61436a496404/schema)