---
title: "Search the requests, lists and sources you can open"
method: GET
path: "/v1/search"
---

# Search the requests, lists and sources you can open

`GET /v1/search`

## Request

- Base URL: `https://api.specstream.ai`
- URL: `https://api.specstream.ai/v1/search`
- Auth: API key in header `Authorization`

## Query parameters

- `q` string, required
- `limit` integer
- `cursor` string

## Response `200`

Bounded search page; follow next_cursor even when results is empty

- object
  - `data` WorkspaceSearchPage, required
    - `results` WorkspaceSearchHit[], required
      - `id` string, required
      - `kind` string, required
      - `title` string, required
      - `route` string, required
      - `snippet` string, required
      - `project_id` string, nullable
      - `collection_id` string, nullable
      - `record_id` string, nullable
      - `note_id` string, nullable
      - `imported` boolean, nullable
    - `next_cursor` string, nullable, required

## Other responses

- `default`: Error envelope

---

[API](https://skmtc.dev/specstream/apis/specstream-api.md) · [All operations](https://skmtc.dev/specstream/apis/specstream-api/llms.txt) · [OpenAPI document](https://skmtc.dev/specstream/apis/specstream-api/revisions/5a9f51143a13?raw)