---
title: "List Saved Searches"
method: GET
path: "/api/v2/saved-searches"
tags: ["Saved Searches"]
---

# List Saved Searches

`GET /api/v2/saved-searches`

Retrieves saved searches for the authenticated team (paginated). Results are capped at `limit` (default and maximum 1000). When more records exist than are returned, `meta.total` exceeds `data.length`; clients with large collections must page with `limit`/`offset` to retrieve them all.

## Query parameters

- `limit` integer
- `offset` integer

## Response `200`

Successfully retrieved saved searches

- SavedSearchesListResponse
  - `data` SavedSearch[], required — List of saved search objects.
    - `id` string, required — Unique saved search ID. Server-generated.
    - `name` string, required — Display name for the saved search.
    - `sourceId` string, required — ID of the source this saved search queries.
    - `select` string — Comma-separated list of column expressions to display. Empty uses the source default.
    - `where` string — Row filter expression. The language is controlled by whereLanguage.
    - `whereLanguage` 'lucene' | 'sql' — Language used for the where filter.
    - `orderBy` string — ORDER BY expression. Empty uses the source default.
    - `tags` string[] — Tags used to organize saved searches.
    - `filters` SavedSearchFilter[] — Structured pinned filters applied to the search.
      - `type` 'sql' — Always `sql`. Only SQL predicate filters render in the sidebar.
      - `condition` string, required — SQL predicate applied to the search, in `<column> IN (...)` form.
    - `teamId` string — ID of the team that owns the saved search.
    - `createdAt` string, date-time — Creation timestamp.
    - `updatedAt` string, date-time — Last update timestamp.
  - `meta` PaginationMeta, required
    - `total` integer, required — Total number of items matching the query, ignoring pagination.
    - `limit` integer, required — Maximum number of items returned in this page.
    - `offset` integer, required — Number of items skipped before this page.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden

## Changes

- **2026-07-08** `6f4381730123` — 1 info
  - endpoint added
- **2026-01-30** `ed852374c451` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/changes/api/v2/saved-searches/get.md)

---

[API](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api.md) · [All operations](https://skmtc.dev/hyperdxio/apis/hyperdx-external-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/hyperdxio/hyperdx-external-api/revisions/3399efdca551/schema)