> ## 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.

# Lookup: enrich email for an X handle

> Email-only one-shot enrichment

Email-only enrichment. Sibling of [/lookups/enrich](/api-reference/lookups-enrich) when you only want an email address (skips the LinkedIn SERP work).

## Body

| Field          | Type   | Description                                 |
| -------------- | ------ | ------------------------------------------- |
| `x_handle`     | string | Exactly one of `x_handle` or `x_profile_id` |
| `x_profile_id` | string | Exactly one of `x_handle` or `x_profile_id` |
| `mode`         | enum   | `"verified"` or `"any"`. Default `"any"`.   |

## Response

```json theme={null}
{
  "enrichment_request_id": 999,
  "status": "complete",
  "credit_consumed": true,
  "credits_remaining": 47,
  "email": { "value": "alice@acme.com", "status": "verified", "provider": "prospeo" }
}
```

## Errors

| Code                   | HTTP | When |
| ---------------------- | ---- | ---- |
| `missing_identifier`   | 400  |      |
| `ambiguous_identifier` | 400  |      |
| `x_handle_not_found`   | 404  |      |
| `credits_exhausted`    | 429  |      |
| `profile_fetch_failed` | 503  |      |

## Auth

Bearer API key.