---
title: "Enrich List Contacts"
method: POST
path: "/api/lists/{list_id}/enrich-contacts"
tags: ["KOL Lists"]
---

# Enrich List Contacts

`POST /api/lists/{list_id}/enrich-contacts`

## Request

- Base URL: `https://api.kolens.ai` (the document declares no server; this is the origin it was published from)
- URL: `https://api.kolens.ai/api/lists/{list_id}/enrich-contacts`
- Auth: HTTP bearer

Find + verify a deliverable email for each member of the list.

Pay-for-result per member (workspace-first billing). Returns per-member
outcomes plus a rollup; ``stopped_insufficient_credits`` is True when
the loop halted because the next hit couldn't be paid for.

## Path parameters

- `list_id` string, required

## Headers

- `x-kolens-user-id` string, nullable
- `x-kolens-workspace-id` string, nullable

## Request body

- BatchEnrichRequest
  - `only_missing` boolean: Skip members that already have a verified email.
  - `limit` integer: Max members to process this call.

## Response `200`

Successful Response

- object

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/kolens/apis/kolens-api.md) · [All operations](https://skmtc.dev/kolens/apis/kolens-api/llms.txt) · [OpenAPI document](https://skmtc.dev/kolens/apis/kolens-api/revisions/5d6865ab0a24?raw)