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_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxEndpoints
| Endpoint | Input | Returns |
|---|---|---|
GET /v1/email | email | Person, company, profiles and deliverability for a work address |
GET /v1/find | name + domain, or linkedin | A verified work email |
GET /v1/verify | email | Deliverability only |
GET /v1/account | none | Plan 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
| Status | code | Meaning |
|---|---|---|
| 400 | invalid_request | Missing or malformed input |
| 401 | unauthorized | Missing, wrong or revoked key |
| 402 | no_credits / plan_required | Out of credits, or the account has no paid plan |
| 429 | rate_limited | 60 requests a minute (120 on Pro); see retry_after |
| 502 / 504 | provider_unavailable / provider_timeout | Upstream 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.