<!-- AUTO-GENERATED from the capability registry — regenerate: npm run generate:registry -->

# `peopledatalabs.personEnrich` — People Data Labs operation

> Direct access to People Data Labs's own API, priced in dollars on your Orange Slice key.
> Everything we expose, with prices: https://orangeslice.ai/llms.txt

Find a person's work email and personal emails from their name and company, or their LinkedIn URL.

## Price

**$0.05 per hit**

Billed only when the call resolves an answer. A miss costs nothing.

Orange Slice holds the People Data Labs contract. You never sign up for
them, hold their key, or reconcile their invoice.


## Call it

**CLI**

```bash
orangeslice peopledatalabs person-enrich --company <string> --domain <string> --first-name <string>
```

**HTTP**

```bash
curl -X POST 'https://orangeslice.ai/api/v1/run' \
  -H 'Authorization: Bearer $ORANGESLICE_API_KEY' \
  -H 'Content-Type: application/json' \
  -d '{"capability":"peopledatalabs.personEnrich","input":{"company":"<string>","domain":"<string>","firstName":"<string>"}}'
```

## Inputs

| Field | Type | Required | Description |
|-------|------|----------|-------------|
| `company` | string | No | Company name |
| `domain` | string | No | Company domain, narrows the match |
| `firstName` | string | No | Person's first name |
| `lastName` | string | No | Person's last name |
| `linkedinUrl` | string | No | LinkedIn profile URL |
| `minLikelihood` | number | No | Match confidence floor, 1–10 (default 6) |

Inputs may also be piped as NDJSON, one JSON object per line.

## Output

```json
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "email": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    },
    "email_type": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "work",
            "personal"
          ]
        },
        {
          "type": "null"
        }
      ]
    },
    "work_emails": {
      "default": [],
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "personal_emails": {
      "default": [],
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "vendor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ]
    }
  },
  "required": [
    "email",
    "email_type",
    "work_emails",
    "personal_emails"
  ],
  "additionalProperties": false
}
```

## Before you run

- **Price it first.** `orangeslice peopledatalabs person-enrich --dry-run` returns the
  exact dollar cost and spends nothing.
- **Large runs need approval.** Above the spend-gate threshold a run exits **7**
  until it carries a plan token, and only a dry run mints one.
- **Scopes:** read
- **Permitted uses:** outreach, research

## Exit codes

`0` ok · `2` bad input · `3` auth · `4` not found · `5` provider ·
`6` rate limited · `7` spend gate, nothing billed · `8` timeout ·
`9` a third-party account needs connecting