Features How It Works Pricing Download Verify Log In
← Back to Home

API & Desktop App

Integrate TrueSendy into your workflow. Use our REST API or the Windows desktop app. Requires an Agency Plan API key. 1 key = 100,000 verifications.

TrueSendy Desktop App

Windows installer — double-click to install. Activate with your API key and verify emails right from your desktop.

🖥️ Windows 10/11 📦 ~100 MB 🔑 API Key Required
Download Installer

Authentication

All API requests require an API key passed in the X-API-Key header. Keys are generated from your account dashboard and start with ts_.

Rate limit: 120 requests/minute per API key. Max 500 emails per bulk request.

GET

/api/v1/balance

Check your API key balance — remaining tokens, tokens used, and expiry.

cURL curl -H "X-API-Key: ts_your_key" https://truesendy.com/api/v1/balance
POST

/api/v1/verify

Verify a single email address. Deducts 1 token.

cURL curl -X POST -H "X-API-Key: ts_your_key" -H "Content-Type: application/json" -d '{"email":"user@example.com"}' https://truesendy.com/api/v1/verify
POST

/api/v1/verify-bulk

Verify up to 500 emails in a single request. Tokens are deducted upfront.

cURL curl -X POST -H "X-API-Key: ts_your_key" -H "Content-Type: application/json" -d '{"emails":["a@x.com","b@y.com"]}' https://truesendy.com/api/v1/verify-bulk

Response Status Codes

StatusReason CodeDescription
validsmtp_acceptedMailbox confirmed — safe to send
validpolicy_rejectionServer blocked probe, mailbox likely valid
validcatch_all_domainDomain accepts all — unverifiable but deliverable
invalidmailbox_not_foundServer confirmed mailbox does not exist
invalidno_mx_recordDomain has no mail server
invaliddisposable_domainTemporary/throwaway email provider
errorsmtp_timeoutServer did not respond in time