---
title: "Retrieve saved searches for a specific context"
method: GET
path: "/agency/{agency_id}/saved-searches"
tags: ["Saved Search"]
---

# Retrieve saved searches for a specific context

`GET /agency/{agency_id}/saved-searches`

## Request

- Base URL: `http://localhost:3010/v1`
- URL: `http://localhost:3010/v1/agency/{agency_id}/saved-searches`
- Auth: HTTP basic

## Query parameters

- `page` integer
- `items_per_page` integer
- `name` string
- `reference` string
- `deleted` boolean
- `type` string
- `sortBy` string[]

## Response `200`

List of searches will be returned for specific context

- object[]
  - `name` string, required
  - `description` string
  - `reference` string, required
  - `url` string, required
  - `type` string
  - `_id` string, required
  - `context_id` string, required
  - `context_type` string, required
  - `deleted` boolean, required
  - `__v` integer, required
  - `updated_at` string, date-time, required
  - `created_at` string, date-time, required

## Other responses

- `204`: No content
- `400`: Validation error on get route
- `401`: Failed to authenticate the user making the request
- `403`: Permission denied error
- `default`: unexpected error

---

[API](https://skmtc.dev/staffshift/apis/staffshift-api-gateway.md) - [All operations](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/llms.txt) - [OpenAPI document](https://skmtc.dev/staffshift/apis/staffshift-api-gateway/revisions/1f079f6b65f5?raw)