---
title: "List prospect pools"
method: GET
path: "/v3/prospect_pools"
tags: ["Prospect Pools"]
---

# List prospect pools

`GET /v3/prospect_pools`

## Request

- Base URL: `https://harvest.greenhouse.io`
- URL: `https://harvest.greenhouse.io/v3/prospect_pools`
- Auth: one of:
  - OAuth 2
    - Authorization code: `https://auth.greenhouse.io/authorize`
    - Client credentials
    - Token URL: `https://auth.greenhouse.io/token` scopes: `harvest:prospect_pools:list`
  - HTTP bearer

A prospect pool is an organization-defined collection of prospects (candidates not yet attached to a specific job), typically used to manage talent communities and sourcing pipelines. Each pool has its own ordered set of stages (see `/v3/prospect_pools/{prospect_pool_id}/stages`) that prospects move through, distinct from a job's interview plan. Pools may be restricted to specific departments, offices, or jobs (hiring plans) via `department_ids`, `office_ids`, and `job_ids`; when all three are empty, the pool is available organization-wide.

## Query parameters

- `cursor` string
- `per_page` integer
- `ids` integer[]
- `created_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `updated_at` object
  - `gte` string, date-time
  - `lte` string, date-time
  - `gt` string, date-time
  - `lt` string, date-time
- `department_ids` integer[]
- `office_ids` integer[]
- `job_ids` integer[]
- `fields` string[]
- `active` boolean

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `name` string: Name of the prospect pool, unique within the organization (case-insensitive).
  - `active` boolean: Whether the pool is currently in use. Inactive pools are hidden from CRM workflows but are retained so existing prospects remain queryable.
  - `description` string, nullable: Free-text purpose statement set by the organization (max 500 characters). `null` when no description has been set.
  - `department_ids` integer[]: Ids of departments this pool is restricted to. Empty when the pool is not restricted by department; combined with `office_ids` and `job_ids`, an empty array on all three means the pool is unrestricted (available org-wide).
  - `office_ids` integer[]: Ids of offices this pool is restricted to. Empty when the pool is not restricted by office.
  - `job_ids` integer[]: Ids of jobs this pool is restricted to. Empty when the pool is not restricted by job.

---

[API](https://skmtc.dev/greenhouse/apis/harvest-api.md) - [All operations](https://skmtc.dev/greenhouse/apis/harvest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/greenhouse/apis/harvest-api/revisions/822822e3f771?raw)