> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchthegoodones.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Enrich a lead

> On-demand LinkedIn + email enrichment for a specific lead

Enriches a specific lead with LinkedIn URL and/or email. Consumes credits. Same engine as the extension lookup surface, but scoped to a lead row you already have.

## Body

| Field               | Type             | Description                               |
| ------------------- | ---------------- | ----------------------------------------- |
| `requested_outputs` | array (required) | `["linkedin_url"]`, `["email"]`, or both  |
| `email_mode`        | enum             | `"verified"` or `"any"`. Default `"any"`. |

## Response

```json theme={null}
{
  "leadId": 1234,
  "x_profile_id": "1234567890",
  "result": {
    "ok": true,
    "kind": "resolved",
    "linkedin": { "url": "https://linkedin.com/in/alice", "confidence": "high" },
    "email": { "address": "alice@acme.com", "status": "verified", "provider": "prospeo" }
  },
  "credits_remaining": 47,
  "contact_routes": [
    { "routeType": "linkedin_url", "value": "...", "confidence": "high" }
  ]
}
```

## Errors

| Code                | HTTP | When                        |
| ------------------- | ---- | --------------------------- |
| `lead_not_found`    | 404  | Lead not owned by user      |
| `profile_missing`   | 404  | x\_profiles row not in DB   |
| `credits_exhausted` | 429  | Team credit balance too low |
| `no_team`           | 400  | User has no team membership |

## Auth

Bearer API key.