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.