---
title: "Enrich Lead"
method: POST
path: "/api/sales/leads/{lead_id}/enrich"
tags: ["Lead Enrichment"]
---

# Enrich Lead

`POST /api/sales/leads/{lead_id}/enrich`

## Request

- Base URL: `https://api.ruzora.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ruzora.com/api/sales/leads/{lead_id}/enrich`
- Auth: HTTP bearer

Trigger enrichment for one lead. Idempotent — returns cached result if
already enriched (use /regenerate to force re-run).

## Path parameters

- `lead_id` string, required

## Query parameters

- `dry_run` boolean

## Response `200`

Successful Response

- EnrichLeadResponse
  - `lead_id` string, required
  - `status` string, required
  - `score` integer, nullable
  - `urgency` string, nullable
  - `primary_signal` string, nullable
  - `ai_opener` string, nullable
  - `cost_cents` integer
  - `prompt_version` string, nullable
  - `signals_summary` object: which providers returned data (true) vs skipped/failed (false)
  - `error` string, nullable

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api.md) · [All operations](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ruzora/apis/ruzora-candidate-crm-api/revisions/f9b8223f3ac4?raw)