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

# Get Creator Emails

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

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.

| Before you start | Details |
| - | - |
| Auth | API key or OAuth |
| Resource | Instagram creator ID or handle |
| Cost | 5 credits per unique resolved creator with returned emails |
| Limits | 1–100 lookups per request; empty email arrays are not billed |

Each resolved creator includes their available email addresses and validation status. Check each address's `status` and timestamps before adding it to your outreach workflow.

```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": "alexrivera.fit" },
      { "platform": "instagram", "username": "missing_example" }
    ]
  }'
```

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

## Inspect the response

This fictional example has one resolved creator with an unvalidated email, plus one unresolved input. Results preserve input order:

```json theme={null}
{
  "data": {
    "results": [
      {
        "input": {"platform": "instagram", "username": "alexrivera.fit"},
        "creator_id": "123e4567-e89b-12d3-a456-426614174000",
        "resolved": true,
        "emails": [{
          "email": "alex@example.com", "status": "unvalidated", "confidence": null,
          "is_primary": true, "validated_at": null,
          "first_seen_at": "2026-10-01T12:00:00Z", "last_seen_at": "2026-10-05T12:00:00Z"
        }]
      },
      {
        "input": {"platform": "instagram", "username": "missing_example"},
        "creator_id": null, "resolved": false, "emails": []
      }
    ],
    "billing": {"billable_results": 1, "credits_charged": 5}
  }
}
```

One resolved creator with emails costs 5 credits (\$0.05); the unresolved row costs nothing. A resolved creator with an empty `emails` array also costs nothing. Neither an empty array nor a successful resolution promises a deliverable address.

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

## Choose how to use an address

| Status | Application handling |
| - | - |
| `unvalidated` | Display as unvalidated; do not infer deliverability from a confidence score |
| `risky` | Keep out of automatic send queues pending your review |
| `valid` | Inspect `validated_at`; a historical validation is not a delivery guarantee |
| `creator_verified` | Preserve the verification label and timestamps; do not infer current deliverability |

`resolved: false` means the creator was not resolved. `resolved: true` with `emails: []` means no email address was returned for that creator. For missing Instagram handles, see [ingestion](/guides/ingest-creators-on-demand); for temporary failures, use [Error Handling](/guides/error-handling).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.