> ## Documentation Index
> Fetch the complete documentation index at: https://storeinspect.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Contact reveal

> Reveal selected contact channels with shared StoreInspect credits.

Use `POST /contacts/reveal` after selecting contacts from search or enrichment previews.

```bash theme={null}
curl https://storeinspect.com/api/v1/contacts/reveal \
  -H "Authorization: Bearer $STOREINSPECT_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: reveal-batch-001" \
  -d '{
    "contact_ids": [
      "ct_Kx2Pq9Q7rVh3_4nQm8sTzY6pLwE",
      "ct_Ab7Lm2Qr8Nz5_Ps4Tg6Vx9Yw2H"
    ]
  }'
```

## Idempotency

Set an `Idempotency-Key` header when retrying reveal requests. Reusing the same key with a different request body returns an idempotency conflict.

## Credit behavior

* First reveal for a contact spends one shared contact credit.
* Re-revealing a contact already revealed by the same account does not spend another credit.
* Invalid IDs and not-found contacts do not spend credits.

<Warning>
  StoreInspect filters out non-exportable contact channels such as bounced, catch-all, guessed, suppressed, or otherwise unsafe emails.
</Warning>