---
title: "Reveal Phone Results"
method: POST
path: "reveal_phones"
---

# Reveal Phone Results

`POST reveal_phones` (webhook)

When the phone verifications are done, the results will be sent to you via a POST request to
the url you passed in the Reveal endpoint.

## Payload

- PublicRevealPhoneWebhookResult
  - `phones` PublicApiModelsRevealPhonesPhone[], required — Phone data, sent back in the same order as the input ids.
    - `numbers` string[], nullable, required — Phone numbers
    - `status` 'verified' | 'notFound' | 'inProgress', required — Status of the phone numbers: verified or not found
    - `personId` string, required — Ocean ID of the person
  - `creditsUsed` number, required — Number of credits charged for this request.

## Acknowledgement `200`

Successful Response

- unknown

## Other responses

- `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/a5d5c0530873/schema)