senderscope

Email lookup API · REST · JSON

Three endpoints. One key.

Reverse email lookup, work email finder and verifier for your CRM, sign-up flow or fraud rules. Same data and credits as the dashboard. Available on every paid plan and credit pack.

Using Claude, ChatGPT or Cursor? Connect the Senderscope MCP server instead: same lookups, no code.

Authentication

Create a key in the dashboard under API keys and send it as a bearer token. Keys start with ssk_live_. Keep them on your server; anyone with the key can spend your credits.

Authorization: Bearer ssk_live_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Endpoints

EndpointInputReturns
GET /v1/emailemailPerson, company, profiles and deliverability for a work address
GET /v1/findname + domain, or linkedinA verified work email
GET /v1/verifyemailDeliverability only
GET /v1/accountnonePlan and credits left

Every endpoint also accepts POST with a JSON body carrying the same fields.

curl "https://senderscope.app/v1/email?email=jane@acme.com" \
  -H "Authorization: Bearer $SENDERSCOPE_KEY"

curl "https://senderscope.app/v1/find?name=Jane%20Doe&domain=acme.com" \
  -H "Authorization: Bearer $SENDERSCOPE_KEY"

curl -X POST "https://senderscope.app/v1/find" -H "Content-Type: application/json" \
  -H "Authorization: Bearer $SENDERSCOPE_KEY" \
  -d '{"linkedin":"https://www.linkedin.com/in/jane-doe"}'

Response

{
  "data": {
    "id": "lk_8Jq…",
    "kind": "email",
    "query": { "email": "jane@acme.com" },
    "found": true,
    "mailbox": "work",
    "email": "jane@acme.com",
    "deliverability": { "status": "deliverable", "confidence": 98, "mx_provider": "Google Workspace",
                        "catch_all": false, "disposable": false, "role_account": false, "spf": true, "dmarc": true },
    "person": { "name": "Jane Doe", "title": "Head of Finance", "seniority": "director", "department": "finance",
                "decision_role": "decision_maker", "location": "Austin, US", "linkedin_url": "https://www.linkedin.com/in/…" },
    "company": { "name": "Acme", "domain": "acme.com", "industry": "Software", "employees": 412, "tech": ["nextjs"], "socials": { … } },
    "profiles": [ { "label": "LinkedIn (person)", "url": "…" } ],
    "credits_charged": 1,
    "cached": false
  },
  "credits_remaining": 1499
}

found is false when nothing is on record; then credits_charged is 0. suppressed: true means the person opted out and nothing about them is returned. note explains skipped cases such as personal webmail.

Errors and limits

StatuscodeMeaning
400invalid_requestMissing or malformed input
401unauthorizedMissing, wrong or revoked key
402no_credits / plan_requiredOut of credits, or the account has no paid plan
429rate_limited60 requests a minute (120 on Pro); see retry_after
502 / 504provider_unavailable / provider_timeoutUpstream data source didn't answer; not charged, retry later

Errors are JSON: {"error":{"code":"…","message":"…"}}. Lookups typically take 1 to 4 seconds (the live mailbox check is the slow part); repeated lookups are served from cache.

Permitted use

The API carries the same rules as the app: business purposes only, never for FCRA-covered decisions, respect opt-outs and anti-spam law. See acceptable use.

Questions