---
title: "Retrieve starred search"
method: GET
path: "/starred_searches/{id}"
tags: ["Starred searches"]
---

# Retrieve starred search

`GET /starred_searches/{id}`

## Request

- Base URL: `https://api.pipelinecrm.com/api/v3`
- URL: `https://api.pipelinecrm.com/api/v3/starred_searches/{id}`
- Auth: one of:
  - HTTP bearer
  - HTTP bearer and API key in header `app-key`
  - API key in query parameter `api_key` and API key in query parameter `app_key`

## Path parameters

- `id` integer, required

## Response `200`

Successful Response

- StarredSearchAll: A saved list view the user has starred. Details are present only with `include_search_details=true`.
  - `id` integer
  - `name` string
  - `search_type` string, nullable
  - `result_count` integer, nullable
  - `url` string, nullable: Path of the list view in the app
  - `updated_at` string, nullable

## Other responses

- `404`: No record with that id is visible to this user. Records owned by other users that you cannot see also answer 404.

---

[API](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api.md) · [All operations](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/pipelinecrm/apis/pipeline-crm-api/revisions/53ebfcc83597?raw)