> ## 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.

# Credits and reveals

> Understand shared contact credits and API reveal behavior.

StoreInspect contact credits are shared across the web app and API.

If a plan includes 3,000 monthly contact credits, reveals from both the web app and API spend from the same pool.

## Reveal rules

* `POST /contacts/search` returns contact previews and does not spend credits.
* `POST /contacts/reveal` returns contact channels for selected contact IDs.
* Revealing a contact for the first time spends one shared contact credit.
* Re-revealing the same contact for the same account does not spend another credit.
* Use an `Idempotency-Key` header when retrying reveal requests.
* Search previews do not include raw emails, phone numbers, or LinkedIn URLs.

```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_AbCdEf_GhIjKlMnOpQrStUv",
      "ct_ZyXwVu_TsRqPoNmLkJiHgFe"
    ]
  }'
```

<Warning>
  Contact IDs are opaque. Always use IDs returned by StoreInspect responses and never construct your own.
</Warning>