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

# Enrich from a work email

`POST /api/v1/enrich/from-email`

Authentication: API key.

JSON array of work emails. One credit per item where `success` is `true`. `creditsRemaining` may be `null` on unlimited plans.

### Body parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `items` | array | yes |  | Each element must include `email` (string). |

### Response fields

| Field | Type | Description |
| --- | --- | --- |
| `ok` | boolean | True when the request succeeded. |
| `results` | array | One result object for each item you sent, in the same order. |
| `creditsRemaining` | number | Plan credits left after this request. Null on unlimited plans. |

### Example request

```bash
curl -sS -X POST "https://leadmcp.ai/api/v1/enrich/from-email" \
  -H "X-API-Key: lb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"email":"jane@acme.com"}]}'
```

### Example response (200)

```json
{
  "ok": true,
  "results": [
    {
      "email": "jane@acme.com",
      "success": true,
      "profileUrl": "https://www.linkedin.com/in/janedoe",
      "data": {
        "email_address": "jane@acme.com",
        "person_linkedin_url": "https://www.linkedin.com/in/janedoe",
        "first_name": "Jane",
        "last_name": "Doe"
      }
    },
    {
      "email": "bob@example.com",
      "success": false,
      "profileUrl": null,
      "data": null
    }
  ],
  "creditsRemaining": 4999
}
```