API ReferenceLead FinderReveal a field
POST/v2/campaigns/lead-finder/enrich-field

Reveal a field

Unmasks one field (email or mobile) for a specific person returned by Search people.

Stablescope: write API KeyLearn about API scopes →

Costs credits even on a cache hit

1 credit for email, 9 for mobile — charged even if this exact person was already revealed before (by you or anyone else), since you're still getting the value. The only thing a cache hit skips is the live provider call.

Refunded if nothing verified is on file

If the provider has no verified value for this field, the credit is refunded and this returns 404 instead of a null value.

Request

AuthorizationBearer YOUR_API_KEY
Content-Typeapplication/json

Parameters

FieldTypeRequiredDescription
personIdstringRequiredFrom a Search people result.
fieldenumRequired"email" | "mobile".
curl -X POST "https://api.stynar.com/v2/campaigns/lead-finder/enrich-field" \
  -H "Authorization: Bearer esk_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{"personId":"prs_a1b2c3","field":"email"}'

Response

✓ 200 OK
200 response
{
  "email": "jane@acme.com",
  "mobile": null
}

Response fields

Errors

StatusCodeMeaning
✕ 404 Not FoundNOT_FOUNDNo verified value for this field/person.
✕ 402 INSUFFICIENT_CREDITSNot enough credits (email reveal costs 1, mobile costs 9).
✕ 401 UnauthorizedUNAUTHORIZEDMissing, malformed, unknown, revoked, or expired key.
✕ 403 ForbiddenAPI_ACCESS_DISABLEDAPI access is turned off for your account.
✕ 403 ForbiddenINSUFFICIENT_SCOPEThe key doesn't have the scope this endpoint requires.
✕ 409 ConflictCONFLICTThe action can't be applied to the resource's current state.
✕ 429 Too Many RequestsRATE_LIMIT_EXCEEDEDPer-minute or per-second limit hit.
✕ 429 Too Many RequestsQUOTA_EXCEEDEDMonthly quota exhausted.
✕ 500 Internal Server ErrorINTERNAL_ERRORSomething broke on Stynar's end.
Full error reference →
PreviousGet filter suggestionsNextCheck enrichment status