---
title: "List prospect details"
method: GET
path: "/v3/prospect_details"
tags: ["Prospect Details"]
---

# List prospect details

`GET /v3/prospect_details`

A prospect detail is the per-prospect record that captures where a candidate sits in the CRM: which prospect pool and stage they currently occupy, who owns them, and the department/office they are being considered for. Each prospect detail is attached to exactly one prospect application (an application that has not yet been moved onto a job); together with `/v3/prospect_pools` and `/v3/prospect_pool_stages`, these rows let an integration reconstruct the full state of a customer's CRM pipeline. `department_id` and `office_id` are derived from the application's prospective department record, not from the candidate or job, so they may differ from the offices and departments returned by other endpoints for the same application.

## 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
- `application_ids` integer[]
- `pool_ids` integer[]
- `pool_stage_ids` integer[]
- `prospect_owner_ids` integer[]
- `department_ids` integer[]
- `office_ids` integer[]
- `fields` string[]

## Response `200`

Successful

- object[]
  - `id` integer
  - `created_at` string, date-time
  - `updated_at` string, date-time
  - `application_id` integer — Id of the prospect application this record belongs to. Each prospect detail is attached to exactly one application; prospects are applications that have not yet been moved onto a job.
  - `pool_id` integer, nullable — Id of the prospect pool the prospect currently sits in (`prospect_pools.id`). `null` when the prospect has been added to the CRM without being placed in a pool yet.
  - `pool_stage_id` integer, nullable — Id of the prospect pool stage the prospect currently sits in (`prospect_pool_stages.id`). `null` when the prospect has no current stage; when set, it is always a stage that belongs to `pool_id`.
  - `prospect_owner_id` integer, nullable — Id of the Greenhouse user designated as the owner of this prospect. `null` when the prospect is unowned.
  - `department_id` integer — Id of the department recorded on the prospect's prospective department (the department the prospect is being considered for), derived from the underlying application.
  - `office_id` integer — Id of the office recorded on the prospect's prospective department (the office the prospect is being considered for), derived from the underlying application.

---

[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)