> ## 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 name and company

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

Authentication: API key.

JSON array of person records. Each item needs `first_name`, `last_name`, and at least one of `company_name` or `email_domain`. Same batch size cap as other batch routes (100 items per request). `creditsRemaining` may be `null` on unlimited plans.

### Body parameters

| Name | Type | Required | Default | Description |
| --- | --- | --- | --- | --- |
| `items` | array | yes |  | Each element: `first_name`, `last_name`, and `company_name` and/or `email_domain` (non-empty strings). |

### 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-person" \
  -H "X-API-Key: lb_live_YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"items":[{"first_name":"Jane","last_name":"Doe","company_name":"Acme Inc"}]}'
```

### Example response (200)

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