MailTester Ninja Email Verification and Finder API
One GET request per address. MailTester Ninja checks the address against the recipient's live mail server (syntax, domain, MX records, then an SMTP…
Fork copies the collection into your workspace, without the publisher's secrets, so you can add your own key and send requests. Star saves it to your starred APIs (Account › Marketplace) and helps others find it.
Overview
One GET request per address. MailTester Ninja checks the address against the recipient's live mail server (syntax, domain, MX records, then an SMTP conversation that stops before any message is sent) and returns a verdict. Nothing is stored.
Branch your code on code:
| code | Meaning | Typical message |
|---|---|---|
ok | Valid and deliverable | Accepted |
ko | Invalid, will bounce | Rejected, No MX, Disposable, Limited |
mb | Uncertain: the domain accepts everything or could not be probed | Catch-All, MX Error, Timeout, SPAM Block, Greylisted, Abuse |
-- | No verdict, the address was not checked | Invalid Key, Disabled Key, free limit message (HTTP 429) |
A catch-all domain is never reported as valid. Never drop an address on a -- answer: fix the key, or wait and retry.
Keys and limits. Pass key=free to try the API with no signup (10 checks a day per IP), a free token mtf_... from https://mailtester.ninja/free-email-verification-api/ (50 checks a day, valid 7 days), or a subscription key sub_... from https://mailtester.ninja/verify-emails-unlimited/. The free tier allows one request every 30 seconds. A paid key allows its daily limit divided by 8640 requests per 10 seconds, for all connections together (Pro 11, Ultimate 23 per 10 seconds; buy a quantity to multiply it).
Finder API. GET /find takes first, last and domain and tests the most common address formats one by one (first.last, flast, first, firstlast, first_last, f.last) until the mail server accepts one. It stops early when the answer applies to the whole domain: on a catch-all domain the most common format is returned as guess. Personal email providers such as gmail.com are not searched. Paid keys only. Each format tested counts as one verification against the daily limit and the rate of the key, even when nothing is found; the /find call itself is not counted. The search paces its formats within the rate of the key; if the key is already at its maximum, it answers HTTP 429 with a Retry-After header. One key can run up to 60 searches an hour on the same domain.
Content type. On /ninja, send Accept: application/json to receive application/json; without it the same JSON body is served as text/plain. /find always answers application/json.
Code examples for cURL, Python, Node.js, PHP, Go, Ruby, Java, C#, Google Sheets, n8n, Make, Zapier, Clay and AI agents: https://mailtester.ninja/integrations/code-examples/ (also on GitHub: https://github.com/mailtester-ninja/mailtester-api-examples)
Endpoints 2
Verification
- GETVerify an email address
/ninja?email=info@apple.comChecks one email address in real time and returns a verdict. Use code to decide (ok send, ko drop, mb decide by risk, -- no verdict) and show message to…
Finder
- GETFind a work email address
/find?first=Tim&last=Cook&domain=apple.comTests the most common address formats for a person at a company domain, one by one and in order of frequency (first.last, flast, first, firstlast, first_last,…
API details
- Base URL
https://happy.mailtester.ninja- Authentication
- An API key in the key query parameter
- Operations
- 2 operations on 2 pathsGET 2
- Main resources
- Finder 1Verification 1
- Response formats
application/jsontext/plaintext/html- Description format
- OpenAPI 3.1.0, API version
1.3.0 - Links
- Documentation · OpenAPI document · Terms of service · Support
- Listed from
- Mailtester's published OpenAPI description
How to test the MailTester Ninja Email Verification and Finder API in Swastik Codes
- Open the APISelect “Fork & run in Swastik Codes” on this page. Sign in or create a free account if asked.
- Fork it into your workspaceChoose a workspace. You get your own copy of the MailTester Ninja Email Verification and Finder API collection, without the publisher's secrets.
- Add your credentialsThis API uses an API key in the key query parameter. Add yours in the collection's variables or an environment; the requests already reference it.
- Send a requestPick an endpoint, for example “Verify an email address” (GET /ninja?email=info@apple.com), and press Send. Check the response, add tests and run the whole collection with the runner.
Frequently asked questions
What is the MailTester Ninja Email Verification and Finder API?
One GET request per address. MailTester Ninja checks the address against the recipient's live mail server (syntax, domain, MX records, then an SMTP… It is listed under Communication and has 2 endpoints.
Who publishes the MailTester Ninja Email Verification and Finder API?
It is listed from Mailtester's public API description (an OpenAPI document), not published by Mailtester on Swastik Codes. Anyone who controls mailtester.ninja can claim the profile by adding a DNS TXT record.
What is the base URL of the MailTester Ninja Email Verification and Finder API?
Requests go to https://happy.mailtester.ninja. Endpoint paths are added to this base URL.
How do I authenticate with the MailTester Ninja Email Verification and Finder API?
With an API key in the key query parameter.
How many endpoints does the MailTester Ninja Email Verification and Finder API have?
2 operations on 2 paths (2 GET). The largest groups are Finder, Verification.
Is forking the MailTester Ninja Email Verification and Finder API free?
Yes. Forking copies the collection into your workspace for free. It has been starred 0 times and forked 0 times.