Academy › Email Verification API Developer Certification › Lesson 1 of 3
API basics: keys and your first check
A verification API lets your own software check an address the same way the website does.
API keys
- Create a key in your account (for Domailfix: API key in your account).
- Send it with each request in a header, for example X-API-Key or Authorization: Bearer.
- Keep it on your server. Never put an API key in website code or a mobile app, where anyone can read it.
A first check
A single check is usually one request with the email address, which returns a JSON answer: the status (deliverable, undeliverable, risky or unknown), a reason and a score.
Full endpoints and examples are in the API docs.
Start in a test script
Try a few known addresses (your own, a made-up one, a typo domain) and look at each answer before building it into your product.
Key idea: keep the key on your server, send it in a header, and test with known addresses first.