---
title: "Reveal contact email and phone"
method: POST
path: "/api/employees/contact-finder/reveal"
tags: ["Contact Finder"]
---

# Reveal contact email and phone

`POST /api/employees/contact-finder/reveal`

## Request

- Base URL: `https://quickenrich.io`
- URL: `https://quickenrich.io/api/employees/contact-finder/reveal`
- Auth: HTTP bearer

Unlock email/phone for a contact from a prior search. Provide one of: `document_id`, `emp_id`, `employee_linkedin`, or (`first_name` + `last_name` + `company_url`). Consumes credits when reveal succeeds.

## Request body

- ContactFinderRevealRequest
  - `document_id` string
  - `emp_id` integer
  - `employee_linkedin` string
  - `first_name` string
  - `last_name` string
  - `company_url` string

## Response `200`

Contact revealed with email and phone.

- object
  - `success` boolean, required
  - `message` string, required
  - `code` integer, required
  - `data` ContactFinderEmployeeRevealed: Masked contact (no email/phone values). Use reveal to unlock.
    - `emp_id` integer, nullable
    - `first_name` string
    - `last_name` string
    - `title` string
    - `employee_linkedin` string
    - `has_email` boolean
    - `has_phone` boolean
    - `has_linkedin` boolean
    - `company_url` string
    - `company_name` string
    - `email_domain` string
    - `home_page_email` string
    - `company_linked` string
    - `company_phone` string
    - `industry` string
    - `revenue` string
    - `employee_count` string
    - `address1` string
    - `address2` string
    - `city` string
    - `region_code` string
    - `zip` string
    - `locality` string
    - `country_code` string
    - `email` string
    - `employee_phone` string
    - `employee_phone_type` string
    - `email_verification_date` string, nullable
  - `meta` object
    - `credits_used` integer
    - `remaining_credits` integer
    - `reason` 'EMPLOYEE_NOT_FOUND' | 'EMAIL_NOT_FOUND' | 'PHONE_NOT_FOUND' | 'COMPANY_NOT_FOUND': Present on empty/not-found success responses.

## Other responses

- `401`: Missing, invalid, or inactive API key
- `402`: Insufficient credits
- `404`: Contact not found
- `422`: Validation failed
- `429`: Rate limit exceeded
- `500`: Upstream/search service error

---

[API](https://skmtc.dev/quickenrich/apis/quick-enrich-api.md) - [All operations](https://skmtc.dev/quickenrich/apis/quick-enrich-api/llms.txt) - [OpenAPI document](https://skmtc.dev/quickenrich/apis/quick-enrich-api/revisions/581bb7f6ae10?raw)