---
title: "List libraries"
method: GET
path: "/v2/teamspaces/{teamspaceId}/libraries"
tags: ["Teamspace Libraries"]
---

# List libraries

`GET /v2/teamspaces/{teamspaceId}/libraries`

## Request

- Base URL: `https://context7.com/api`
- URL: `https://context7.com/api/v2/teamspaces/{teamspaceId}/libraries`
- Auth: HTTP bearer

The teamspace's private sources and the libraries it has claimed, each with its parse state. Use the library details for versions and the progress of a running parse.

## Path parameters

- `teamspaceId` string, uuid, required

## Response `200`

The libraries

- object
  - `libraries` TeamspaceLibrarySummary[], required
    - `id` string, required: Library id, `/owner/repo`.
    - `title` string
    - `description` string
    - `type` 'repo' | 'llmstxt' | 'website' | 'openapi' | 'pdf' | 'docx' | 'file' | 'confluence' | 'notion': Source type.
    - `sourceUrl` string: Where the library is read from (repository, website, llms.txt or OpenAPI URL).
    - `branch` string: Default branch (repositories).
    - `private` boolean, required: One of the teamspace's private sources.
    - `owned` boolean, required: Claimed by the teamspace. Owner operations (config, versions delete, analytics) need it.
    - `state` 'processing' | 'finalizing' | 'complete' | 'error', required: Parse state. `processing`: a parse runs. `finalizing`: the new data is ready and cleanup still runs. `complete`: done. `error`: the last parse failed, or a first parse ended without a library.
    - `lastUpdateDate` string, date-time: Last successful update.
    - `totalTokens` integer
    - `totalSnippets` integer
    - `totalPages` integer
    - `benchmarkScore` number: Context7's benchmark score of the library's docs, 0 to 100.

## Other responses

- `400`: Bad Request - Invalid input parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: The caller cannot access this teamspace, the API key belongs to another teamspace, or the caller's role is too low
- `500`: Internal Server Error

## Changes

- **2026-10-22** `cd09292c6641`: 1 info
  - added the optional property `libraries/items/benchmarkScore` to the response with the `200` status
- **2026-10-22** `e17589fd8767`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context7/apis/context7-public-api/changes/v2/teamspaces/:teamspaceId/libraries/get.md)

---

[API](https://skmtc.dev/context7/apis/context7-public-api.md) - [All operations](https://skmtc.dev/context7/apis/context7-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/context7/apis/context7-public-api/revisions/945f7834fa8c?raw)