---
title: "Enrich leads you already own (SPENDS TOKENS)"
method: POST
path: "/api/enrich"
---

# Enrich leads you already own (SPENDS TOKENS)

`POST /api/enrich`

## Request

- Base URL: `https://lyreleads.com`
- URL: `https://lyreleads.com/api/enrich`
- Auth: HTTP bearer

Reads each website and fills the technology, contact and signal fields, and verifies every address it finds: one lead per five businesses, on any business you hold, whether it is enrolled or not. It does not enroll anything; to keep businesses re-checked monthly, use POST /api/v1/leads/enroll. Without force, businesses that are already enriched are skipped. A brand-new business found by a search is already enriched and enrolled at no extra cost. Get the exact maximum first, free, with POST /api/v1/enrich/preview. Runs as a job, poll GET /api/enrich/progress/{jobId}. Lead-spending limit: 30,000 businesses a minute on Growth, up to 150,000 on Agency.

## Request body

- object
  - `resultIds` integer[], required
  - `force` boolean: Also re-read leads that are already enriched, at the same 1 token per 5.
  - `categories` string[]
  - `overwriteExisting` boolean

## Response `200`

jobId

## Other responses

- `402`: Insufficient leads; the body carries leads_needed, leads_balance, enrolled and not_enrolled
- `429`: Rate limit exceeded

---

[API](https://skmtc.dev/lyreleads/apis/lyre-leads-api.md) · [All operations](https://skmtc.dev/lyreleads/apis/lyre-leads-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lyreleads/apis/lyre-leads-api/revisions/1c7c73cc355f?raw)