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

# Reveal contacts

`POST /contacts/reveal`

## Request

- Base URL: `https://storeinspect.com/api/v1`
- URL: `https://storeinspect.com/api/v1/contacts/reveal`
- Auth: HTTP bearer

Reveals full contact identity and contact channels with shared contact credits, a unique-store export allowance for delivered store data, and optional idempotency protection.

## Headers

- `Idempotency-Key` string

## Request body

- ContactRevealRequest
  - `contact_ids` string[], required

## Response `200`

Full contact data for contacts revealed with shared contact credits.

- ContactRevealResponse
  - `object` 'contact_reveal_result', required
  - `credits` object, required
    - `spent` integer, required
    - `remaining` integer, required
  - `data` Contact[], required
    - `id` string
    - `object` 'contact'
    - `full_name` string, nullable
    - `first_name` string, nullable
    - `last_name` string, nullable
    - `title` string, nullable
    - `role` string, nullable
    - `seniority` 'executive' | 'decision_maker' | 'other'
    - `linkedin_url` string, nullable
    - `reveal_status` 'newly_revealed' | 'already_revealed'
    - `charged` boolean
    - `emails` object[]
      - `email` string
      - `status` string
      - `type` string
      - `is_primary` boolean
    - `phones` object[]
      - `phone` string
      - `type` string
      - `is_primary` boolean
    - `store` object
      - `id` string
      - `domain` string
      - `name` string
    - `revealed_at` string, date-time
  - `request_id` string, required

## Other responses

- `400`: Invalid contact IDs.
- `401`: Missing or invalid API key.
- `402`: Not enough contact credits. Trial users receive a billing action when ending the trial would unlock paid Pro credits immediately.
- `403`: The account does not have API access.
- `404`: No revealable contacts were found.

---

[API](https://skmtc.dev/storeinspect/apis/storeinspect-api.md) · [All operations](https://skmtc.dev/storeinspect/apis/storeinspect-api/llms.txt) · [OpenAPI document](https://skmtc.dev/storeinspect/apis/storeinspect-api/revisions/e9477dd90cf9?raw)