---
title: "GET /public/v1/prospect-lists"
method: GET
path: "/public/v1/prospect-lists"
tags: ["Lists"]
---

# GET /public/v1/prospect-lists

`GET /public/v1/prospect-lists`

## Request

- Base URL: `https://api.joinvalley.co`
- URL: `https://api.joinvalley.co/public/v1/prospect-lists`
- Auth: API key in header `x-api-key`
- TypeScript: <https://skmtc.dev/joinvalley/apis/valley-public-api/docs/public/v1/prospect-lists/get.ts> (a function with typed inputs; its response is checked against the schema)

List the saved lists in a workspace, newest first. Workspace owners, admins and managers see every seat's lists (filter one seat with ownerId); members see their own. type=PLAY returns the lists plays built, which stay after their campaign is deleted.

## Query parameters

- `workspaceId` string
- `ownerId` string
- `type` 'SALES_NAV' | 'CRUST' | 'WIZA_SEARCH' | 'CSV' | 'LINKEDIN_SEARCH' | 'SALES_NAV_SEARCH' | 'RECRUITER_SEARCH' | 'LINKEDIN_POST' | 'WARM_LIST' | 'CLAY' | 'DEEP_SEARCH' | 'PLAY'
- `limit` number
- `offset` number

## Response `200`

Default Response

- object
  - `statusCode` number
  - `status` boolean
  - `message` string
  - `data` object
    - `lists` object[]
      - `id` string
      - `name` string
      - `type` string
      - `createdAt` string
      - `people` number
      - `owner` object
        - `id` string
        - `name` string, nullable
        - `email` string, nullable
      - `play` object, nullable
        - `playKey` string, nullable
        - `campaignId` string
        - `campaignName` string, nullable
        - `campaignDeleted` boolean
    - `pagination` object
      - `limit` number
      - `offset` number
      - `total` number
      - `hasMore` boolean

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `429`: Default Response
- `500`: Default Response

## Changes

- **2026-10-22** `f783c1756212`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/joinvalley/apis/valley-public-api/changes/public/v1/prospect-lists/get.md)

---

[API](https://skmtc.dev/joinvalley/apis/valley-public-api.md) - [All operations](https://skmtc.dev/joinvalley/apis/valley-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/joinvalley/apis/valley-public-api/revisions/798c2eb1b512?raw)