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

# Lookup Creator Emails

> How to fetch known creator email addresses by creator ID or social username.

# Lookup Creator Emails

Use `POST /v1/creator-emails/lookup` to fetch known email addresses for creators. You can look up creators by Influship creator ID or by social username.

The endpoint returns every API-visible email we have for each resolved creator. Emails can be `unvalidated`, so check `status` before treating an address as deliverable.

```bash theme={null}
curl -s "https://api.influship.com/v1/creator-emails/lookup" \
  -H "X-API-Key: $INFLUSHIP_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "creators": [
      { "platform": "instagram", "username": "creator" },
      { "creator_id": "123e4567-e89b-12d3-a456-426614174000" }
    ]
  }'
```

## Billing

Creator email lookup costs 5 credits per unique resolved creator with at least one returned email. Empty results and unresolved creators are not charged.

The response includes a billing preview:

```json theme={null}
{
  "data": {
    "billing": {
      "billable_results": 1,
      "credits_charged": 5
    }
  }
}
```

## Response fields

Each email includes:

| Field           | Meaning                                                |
| --------------- | ------------------------------------------------------ |
| `email`         | Email address as stored                                |
| `status`        | `unvalidated`, `valid`, `risky`, or `creator_verified` |
| `confidence`    | Nullable score from import or enrichment               |
| `is_primary`    | Whether this is the selected primary email             |
| `validated_at`  | Last validation time, if known                         |
| `first_seen_at` | First time Influship observed the email                |
| `last_seen_at`  | Most recent observation time                           |