---
title: "Get Segment Pool Ladder"
method: GET
path: "/api/app-auto-gtm/segments/{segment_id}/pool-ladder"
tags: ["AppAutoGtm"]
---

# Get Segment Pool Ladder

`GET /api/app-auto-gtm/segments/{segment_id}/pool-ladder`

Pool ladder of one campaign: found -> verified -> ready -> contacted.

T-2751. The Leads tab showed a single raw lead count, so "found 20 000,
sending stopped after 500" read as a bug: nothing said how many addresses
passed verification, how many are still waiting their first email, and who
already got which step of the sequence. Every step here is a subset of the
one above it, and `touches` splits `contacted` by sequence step.

Loaded client-side next to `/leads/breakdown` (same reason: it must never
block the tab's first paint). The two lead steps come from the
trigger-maintained `segment_lead_stats` (T-1245) and from nowhere else:
this endpoint never counts `agent_lead` itself. A campaign whose counter
row is not published yet answers `null` for those steps — unknown, never
zero — while the send-log steps answer as usual.

## Path parameters

- `segment_id` integer, required

## Cookies

- `ex_access` string, nullable
- `ex_org` string, nullable

## Response `200`

Successful Response

- PoolLadder — The Leads-tab pool ladder: found -> verified -> ready -> contacted. Answers the "the numbers don't add up" complaint (T-2751): the tab used to show one raw lead count, so a campaign that found 20 000 leads and stopped sending after 500 looked broken. Each step is a subset of the one above it.
  - `found` integer, nullable, required
  - `email_verified` integer, nullable, required
  - `ready_to_send` integer, nullable, required
  - `contacted` integer, required
  - `touches` PoolTouchGroup[], required
    - `touch_number` integer, required
    - `people` integer, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-03** `582ac44d6b1e` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/explee/apis/explee-api/changes/api/app-auto-gtm/segments/:segment_id/pool-ladder/get.md)

---

[API](https://skmtc.dev/explee/apis/explee-api.md) · [All operations](https://skmtc.dev/explee/apis/explee-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/explee/explee-api/revisions/582ac44d6b1e/schema)