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

# GET /public/v1/prospect-lists/{listId}/prospects

`GET /public/v1/prospect-lists/{listId}/prospects`

## Request

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

The people on a saved list, with each person's email (only an address Valley found and verified, or one you brought) and where they stand in the workspace now: the live campaign they are in, whether they were ever messaged, whether they are on Do Not Contact, and `available` when none of those apply. Paged by cursor: pass back nextCursor until it is null.

## Path parameters

- `listId` string, required

## Query parameters

- `workspaceId` string
- `limit` number
- `cursor` string

## Response `200`

Default Response

- object
  - `statusCode` number
  - `status` boolean
  - `message` string
  - `data` object
    - `list` object
      - `id` string
      - `name` string
      - `type` string
      - `people` number
    - `prospects` object[]
      - `prospectId` string
      - `firstName` string, nullable
      - `lastName` string, nullable
      - `title` string, nullable
      - `company` string, nullable
      - `companyWebsite` string, nullable
      - `location` string, nullable
      - `linkedinUrl` string, nullable
      - `email` string, nullable
      - `emailStatus` string
      - `addedAt` string
      - `inCampaign` object, nullable
        - `campaignId` string
        - `campaignName` string
        - `owner` string, nullable
        - `stage` string
      - `everContacted` boolean
      - `onDoNotContact` boolean
      - `available` boolean
    - `nextCursor` string, nullable

## Other responses

- `400`: Default Response
- `401`: Default Response
- `403`: Default Response
- `404`: 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/:listId/prospects/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)