---
title: "Enrichment Preview"
method: POST
path: "/api/v1/enrichment/preview"
tags: ["enrichment", "enrichment"]
---

# Enrichment Preview

`POST /api/v1/enrichment/preview`

## Request

- Base URL: `https://app.goodleads.club` (the document declares no server; this is the origin it was published from)
- URL: `https://app.goodleads.club/api/v1/enrichment/preview`
- Auth: none declared

Analyze selected leads for enrichment eligibility.

Returns segment breakdown, contact coverage, eligible count, and cost estimate.
Use this before committing to enrichment to understand the cost and value.

Still consumed by the State GM agents (`get_enrichment_preview` tool) — read-only.

## Request body

- EnrichmentRequest
  - `state` string, required
  - `entity_ids` string[], nullable
  - `include_all_matching` boolean
  - `filters` object[]

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/goodleads/apis/formation-gtm-api.md) · [All operations](https://skmtc.dev/goodleads/apis/formation-gtm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/goodleads/apis/formation-gtm-api/revisions/2068d13a82cf?raw)