Phase 1 / planned endpoint
POST
/reverse_email_lookupEmail → business profile
Reverse-resolve a business email to a structured person profile, including employer, title, and LinkedIn URL when available.
Request body
JSON object
emailstring Business email address to resolve.
Example:avery@northstar.dev Response
200 · Processed
A processed request returns status: "ok". The nested result may be empty; in that case tokens_charged remains zero.
results.full_name Resolved person name.
results.title Current job title when known.
results.company Employer name and domain.
results.linkedin_url LinkedIn profile when matched.
metadata.tokens_charged Credits charged for the returned result. Zero for a miss.
metadata.fair_use Remaining records and reset timestamps for applicable plan windows.
Errors
Malformed request body
Missing or invalid API key
Unsupported filter value
Rate limit exceeded