---
title: "List Ask sites"
method: GET
path: "/v2/teamspaces/{teamspaceId}/ask-sites"
tags: ["Ask Sites"]
---

# List Ask sites

`GET /v2/teamspaces/{teamspaceId}/ask-sites`

## Request

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

The teamspace's Ask sites, oldest first, each with the setup markup to install and its index status.

## Path parameters

- `teamspaceId` string, uuid, required

## Response `200`

The sites

- AskSitesResponse
  - `data` AskSite[], required: Oldest first.
    - `siteKey` string, required: Public site key, also the site's id.
    - `url` string, required
    - `hostname` string, required
    - `verification` union, required: Where the site stands in the ownership check.
      - object
        - `kind` 'pending', required
      - object
        - `kind` 'verified', required
        - `verifiedAt` string, date-time, required
      - object
        - `kind` 'failed', required
        - `reason` string, required: What to fix, in words for the site owner.
        - `checkedAt` string, date-time, required
    - `indexStatus` union, required: Indexing of the site into Context7. `pending` until the site is verified and submitted; `submitted` while the parser works; `ready` when the library is finalized; `failed` with a reason (verify again to retry).
      - object
        - `kind` 'pending', required
      - object
        - `kind` 'submitted', required
        - `library` AskLibrary, required
          - `name` string, required: Context7 library id.
          - `title` string, required
          - `description` string, nullable, required
          - `url` string, required
      - object
        - `kind` 'ready', required
        - `library` AskLibrary, required
          - `name` string, required: Context7 library id.
          - `title` string, required
          - `description` string, nullable, required
          - `url` string, required
      - object
        - `kind` 'failed', required
        - `reason` string, required
        - `library` AskLibrary, required
          - `name` string, required: Context7 library id.
          - `title` string, required
          - `description` string, nullable, required
          - `url` string, required
    - `verificationTag` string, required: Required. Add it to the server-rendered `<head>` of every page under `url`. Verify checks for it.
    - `snippet` string, required: Required. The hidden note for agents: an HTML block to add at the top of `<body>` in the shared server-rendered layout. Verify checks for it. Keep the `data-context7-ask` attribute. Do not render it with client-side JavaScript.
    - `markdown` string, required: The same note as a Markdown `## Search` section, for `llms.txt`, `llms-full.txt` and Markdown pages, if the site serves them.
    - `endpoint` string, required: The site's Ask endpoint. Agents append `&query=<URL-encoded question>`.
  - `siteLimit` integer, nullable, required: Most sites the plan allows; null for no limit.
  - `limitReached` string[], required: Keys of the sites that used this month's requests. Their endpoint answers 429 until the next UTC month.

## Other responses

- `400`: Invalid teamspace id or parameters
- `401`: Unauthorized - Invalid or missing API key
- `403`: The caller cannot access this teamspace, or the key belongs to another teamspace
- `500`: Internal Server Error

## Changes

- **2026-10-22** `e17589fd8767`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/context7/apis/context7-public-api/changes/v2/teamspaces/:teamspaceId/ask-sites/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)