---
title: "List deep searches"
method: GET
path: "/deepSearch"
tags: ["Deep Search"]
---

# List deep searches

`GET /deepSearch`

## Request

- Base URL: `https://api.cloudglue.dev/v1`
- URL: `https://api.cloudglue.dev/v1/deepSearch`
- Auth: HTTP bearer

List all deep searches with pagination and filtering options.

## Query parameters

- `limit` integer
- `offset` integer
- `status` 'in_progress' | 'completed' | 'failed' | 'cancelled'
- `created_before` string, date
- `created_after` string, date

## Response `200`

List of deep searches

- DeepSearchList
  - `object` 'list': Object type identifier
  - `data` DeepSearchListItem[]: Array of deep search items
    - `id` string, uuid: Deep search ID
    - `object` 'deep_search': Object type identifier
    - `status` 'in_progress' | 'completed' | 'failed' | 'cancelled': Current status
    - `created_at` number: Unix timestamp of creation
    - `query` string: The original search query
    - `scope` 'segment' | 'file', nullable: The scope the caller requested; null when the request omitted scope (auto)
    - `total` integer: Total number of results
    - `usage` DeepSearchUsage
      - `input_tokens` integer: Number of input tokens used
      - `output_tokens` integer: Number of output tokens used
      - `total_tokens` integer: Total number of tokens used
      - `search_calls` integer: Number of search calls made
  - `total` integer: Total number of deep searches
  - `limit` integer: Maximum number of items returned
  - `offset` integer: Number of items skipped

## Other responses

- `500`: An unexpected error occurred on the server

## Changes

- **2026-10-30** `23d3f240819f`: 1 info
  - added the optional property `code` to the response with the `500` status
- **2026-08-12** `725b9736a231`: 1 breaking
  - the response property `data/items/scope` became nullable for the status `200`
- **2026-03-16** `9dc639e1d66c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/cloudglue/apis/cloudglue-api/changes/deepSearch/get.md)

---

[API](https://skmtc.dev/cloudglue/apis/cloudglue-api.md) - [All operations](https://skmtc.dev/cloudglue/apis/cloudglue-api/llms.txt) - [OpenAPI document](https://skmtc.dev/cloudglue/apis/cloudglue-api/revisions/23d3f240819f?raw)