> ## Documentation index
> Fetch the complete documentation index at: https://context7.com/docs/llms.txt
> Ask it with GET https://context7.com/docs/ask?q=<keywords or question>. Short keywords rank best.
> Use these to discover all available pages before exploring further.
> Feature requests: https://context7.com/docs/resources/feature-requests.md lists what users asked for and how to vote for a request or add one.
> Page rating: `GET https://context7.com/docs/feedback?path=/docs/api-reference/teamspace-libraries/get-a-library&helpful=true` (or `false`) records whether this page helped. An optional `comment` (URL-encoded, at most 500 characters) says what was missing or wrong. It is anonymous and needs no key. Comments hold no code, secrets or personal data.

# Get a library

> The library's parse state, counts, versions and the active parse task. Poll it after adding or refreshing a library. Works for the teamspace's private and claimed libraries, and for any public library.

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

## OpenAPI

````yaml https://context7.com/openapi.json get /v2/teamspaces/{teamspaceId}/libraries/{owner}/{repo}
openapi: 3.0.0
info:
  title: Context7 Public API
  description: The Context7 Public API provides programmatic access to library
    documentation and search functionality. Get up-to-date documentation and
    code examples for any library.
  version: 2.0.0
  contact:
    name: Context7 Support
    url: https://context7.com
    email: support@context7.com
servers:
  - url: https://context7.com/api
    description: Production server
tags:
  - name: Search
    description: Search for libraries in the Context7 database
  - name: Context
    description: Retrieve documentation context for queries
  - name: Ask
    description: Answer questions from a website registered with Context7 Ask
  - name: Refresh
    description: Refresh existing libraries to fetch latest documentation
  - name: Policies
    description: Manage teamspace access policies and filters
  - name: Add Library
    description: Submit new libraries for documentation processing
  - name: Metrics
    description: Retrieve usage metrics for libraries
  - name: Usage
    description: See member and teamspace API usage
  - name: Teamspaces
    description: Teamspaces the caller is a member of. The management API
      (`/v2/teamspaces/*`) accepts a Context7 API key created with management
      access (other keys get 403 `management_access_required`), which reaches
      only its own teamspace, or an OAuth token issued for the Context7 Admin
      MCP server (`https://admin.mcp.context7.com/mcp`), which reaches every
      teamspace of the user. A browser session is not accepted.
  - name: Teamspace Admin
    description: Members, invitations, rules, library policies and requests, usage
      and the spending limit of a teamspace.
  - name: Teamspace Libraries
    description: "A teamspace's libraries: its private sources and the libraries it
      has claimed. Add, refresh, configure, version, claim and remove them, and
      read their parse state and usage. A library id `/owner/repo` is two path
      segments."
  - name: Docs7 Sites
    description: 'Docs7 documentation sites of a teamspace: settings, custom
      domains, deployments, previews and the Docs7 agents. Any member can read;
      owners and admins can change; developers can add a site, publish one added
      for the agents only, and rebuild. Sites deployed with the `docs7 deploy`
      CLI have `source: "local"`; operations marked GitHub-only answer 404 for
      them.'
  - name: Docs7 Analytics
    description: "Traffic of one Docs7 site: visitors, AI crawlers, searches,
      assistant questions and page feedback. Docs7 Free reads the last 7 days,
      Docs7 Pro the last 90."
  - name: Ask Sites
    description: "Manage a teamspace's Context7 Ask sites: add, verify, remove, and
      read their analytics and question log"
paths:
  /v2/teamspaces/{teamspaceId}/libraries/{owner}/{repo}:
    get:
      tags:
        - Teamspace Libraries
      summary: Get a library
      description: The library's parse state, counts, versions and the active parse
        task. Poll it after adding or refreshing a library. Works for the
        teamspace's private and claimed libraries, and for any public library.
      operationId: getTeamspaceLibrary
      security:
        - bearerAuth: []
      responses:
        "200":
          description: The library
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/TeamspaceLibraryDetail"
        "401":
          $ref: "#/components/responses/UnauthorizedError"
        "403":
          description: The caller cannot access this teamspace, the API key belongs to
            another teamspace, or the caller's role is too low
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: forbidden
                message: You do not have access to this teamspace.
        "404":
          description: The teamspace has no library with this id (neither claimed nor one
            of its private sources)
          content:
            application/json:
              schema:
                $ref: "#/components/schemas/Error"
              example:
                error: library_not_found
                message: This teamspace has no library with this id.
        "500":
          $ref: "#/components/responses/InternalServerError"
components:
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: Get your API key at
        [context7.com/dashboard](https://context7.com/dashboard). Treat your API
        key like a password and store it securely.
  schemas:
    Error:
      type: object
      description: Standard error response
      properties:
        error:
          type: string
          description: Error code identifier
        message:
          type: string
          description: Human-readable error message
      required:
        - error
        - message
    TeamspaceLibrarySummary:
      type: object
      description: "A library of the teamspace: one of its private sources or a
        library it has claimed."
      required:
        - id
        - private
        - owned
        - state
      properties:
        id:
          type: string
          description: Library id, `/owner/repo`.
          example: /acme/internal-docs
        title:
          type: string
        description:
          type: string
        type:
          type: string
          enum:
            - repo
            - llmstxt
            - website
            - openapi
            - pdf
            - docx
            - file
            - confluence
            - notion
          description: Source type.
        sourceUrl:
          type: string
          description: Where the library is read from (repository, website, llms.txt or
            OpenAPI URL).
        branch:
          type: string
          description: Default branch (repositories).
        private:
          type: boolean
          description: One of the teamspace's private sources.
        owned:
          type: boolean
          description: Claimed by the teamspace. Owner operations (config, versions
            delete, analytics) need it.
        state:
          type: string
          enum:
            - processing
            - finalizing
            - complete
            - error
          description: "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:
          type: string
          format: date-time
          description: Last successful update.
        totalTokens:
          type: integer
        totalSnippets:
          type: integer
        totalPages:
          type: integer
    TeamspaceLibraryVersion:
      type: object
      description: A tag or branch parsed as a version of its own. The default branch
        is the library itself, not a version.
      required:
        - name
        - isBranch
        - state
      properties:
        name:
          type: string
          description: Tag or branch name. Use it in `DELETE .../versions/{version}`.
          example: v14.0.0
        title:
          type: string
        isBranch:
          type: boolean
        state:
          type: string
          enum:
            - processing
            - finalizing
            - complete
            - error
          description: "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:
          type: string
          format: date-time
        totalTokens:
          type: integer
        totalSnippets:
          type: integer
    TeamspaceLibraryTask:
      type: object
      description: The active parse task, as the public task list shows it.
      required:
        - lockState
        - lockDate
        - task
      properties:
        lockState:
          type: string
          enum:
            - processing
            - waiting
            - crawling
            - crawled
        lockDate:
          type: string
          format: date-time
          description: When the task started.
        progress:
          type: string
          description: The parser's progress line.
          example: Processing 45/120 files, 3/8 chunks
        task:
          type: object
          required:
            - type
            - projectName
            - displayName
          properties:
            type:
              type: string
              description: Task type, for example `parse_repo` or `refresh_website`.
            projectName:
              type: string
              description: Library id, with `@tag` for a version task.
            displayName:
              type: string
    TeamspaceLibraryDetail:
      allOf:
        - $ref: "#/components/schemas/TeamspaceLibrarySummary"
        - type: object
          required:
            - versions
            - task
          properties:
            lastRunDate:
              type: string
              format: date-time
              description: When the last parse ran, successful or not.
            issues:
              type: object
              description: Problems the last parse found.
              properties:
                tooLarge:
                  type: boolean
                noCode:
                  type: boolean
                languageMismatch:
                  type: boolean
                redirect:
                  type: string
                blocked:
                  type: boolean
                disallowed:
                  type: boolean
            versions:
              type: array
              items:
                $ref: "#/components/schemas/TeamspaceLibraryVersion"
            task:
              type: object
              allOf:
                - $ref: "#/components/schemas/TeamspaceLibraryTask"
              nullable: true
              description: The active parse task, or null when none runs.
  responses:
    InternalServerError:
      description: Internal Server Error
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Error"
          example:
            error: internal_error
            message: An error occurred while processing your request
    UnauthorizedError:
      description: Unauthorized - Invalid or missing API key
      content:
        application/json:
          schema:
            $ref: "#/components/schemas/Error"
          example:
            error: invalid_api_key
            message: Invalid API key. Please check your API key. API keys should start with
              'ctx7sk' prefix.
````