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

# List prospect pools

`GET /v3/prospect_pools`

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/auth-api.md) · [All operations](https://skmtc.dev/greenhouse/apis/auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/greenhouse/auth-api/revisions/9517a2e54640/schema)