Skip to main content
Use POST /contacts/reveal after selecting contacts from search or enrichment previews.
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.
StoreInspect filters out non-exportable contact channels such as bounced, catch-all, guessed, suppressed, or otherwise unsafe emails.