---
title: "Reveal emails"
method: POST
path: "/v2/reveal/emails"
tags: ["Reveal"]
---

# Reveal emails

`POST /v2/reveal/emails`

Get emails and email statuses for people.

**Webhook result:**
[Documentation](/docs/webhooks/reveal_emails)

## Query parameters

- `apiToken` string, nullable

## Headers

- `x-api-token` string, nullable

## Request body

- PublicRevealEmailBody
  - `personIds` string[], required — List of Ocean person ids to fetch the email data for. One email credit will be charged for every verified email found.
  - `webhookUrl` string, required — Url of the webhook the email data should be sent to, when completed.

## Response `200`

Successful Response

- PublicRevealEmailResult
  - `status` 'in progress' | 'webhook sent', required — Status of the request. `"in progress"` if any email has to be verified in the background. All the email results are sent to the webhook once they are all done.

## Other responses

- `400` — Bad Request
- `402` — Payment Required
- `403` — Forbidden
- `404` — Not found
- `422` — Validation Error

---

[API](https://skmtc.dev/ocean/apis/ocean-io-api-documentation.md) · [All operations](https://skmtc.dev/ocean/apis/ocean-io-api-documentation/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/ocean/ocean-io-api-documentation/revisions/505121e48722/schema)