---
title: "Initiate enrichment from list"
method: POST
path: "/lists/{listID}/enrich"
tags: ["enrichment"]
---

# Initiate enrichment from list

`POST /lists/{listID}/enrich`

## Request

- Base URL: `https://api.leadsforge.ai`
- URL: `https://api.leadsforge.ai/lists/{listID}/enrich`
- Auth: API key in header `Authorization`

Initiate enrichment from list

## Path parameters

- `listID` string, required

## Request body

- EnrichListRequest
  - `amount` integer
  - `enrichEmail` boolean
  - `enrichLinkedin` boolean
  - `enrichPhoneNumber` boolean
  - `excludeIDs` string[]
  - `includeIDs` string[]
  - `leadQualification` boolean
  - `linkedinEnrichmentCondition` 'none' | 'always' | 'email_found' | 'phone_found' | 'email_or_phone_found' | 'email_and_phone_found'
  - `replaceContactCondition` 'none' | 'until_email_found' | 'until_phone_found' | 'until_email_or_phone_found'

## Response `200`

Queued

- InternalEnrichmentResponse
  - `jobRunID` string
  - `jobTimestamp` integer

## Other responses

- `400`: Bad Request
- `500`: Internal Server Error

---

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