Reveal emails

POST /v2/reveal/emails

Get emails and email statuses for people.

application/json

Body Required

  • personIds array[string] Required

    List of Ocean person ids to fetch the email data for. One email credit will be charged for every verified email found.

    At least 1 but not more than 500 elements.

  • webhookUrl string Required

    Url of the webhook the email data should be sent to, when completed.

Responses

  • 200 application/json

    Successful Response

    Hide response attribute Show response attribute object
    • status string 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.

      Values are in progress or webhook sent.
  • 404

    Not found

  • 422 application/json

    Validation Error

    Hide response attribute Show response attribute object
    • detail array[object]
      Hide detail attributes Show detail attributes object
POST /v2/reveal/emails 
curl \
 -X POST https://api.ocean.io/v2/reveal/emails?apiToken=string \
 -H "Content-Type: application/json" \
 -d '{"personIds":["personId1","personId2"],"webhookUrl":"https://some-url.com"}'
Request examples 
{
  "personIds": [
    "personId1",
    "personId2"
  ],
  "webhookUrl": "https://some-url.com"
}
Response examples (200) 
{
  "status": "in progress"
}
Response examples (422) 
{
  "detail": [
    {
      "loc": [
        "string"
      ],
      "msg": "string",
      "type": "string"
    }
  ]
}