1. Get an API key
Sign up at console.checkharbor.com → Keys → New Key.
Your key looks like chk_live_....
2. Make your first request
curl -X POST https://api.checkharbor.com/v1/email/validate \
-H "X-Api-Key: chk_live_YOUR_KEY" \
-H "Content-Type: application/json" \
-d '{"email": "john.doe@gmail.com"}'
```Response:
```json
{
"input": "john.doe@gmail.com",
"valid_syntax": true,
"mx_found": true,
"disposable": false,
"role_based": false,
"free_provider": true,
"did_you_mean": null,
"deliverability": "deliverable",
"score": 92,
"credits_used": 1
}
```
npm install @checkharbor/node
``````typescript
import { Checkharbor } from "@checkharbor/node";
const checkharbor = new Checkharbor({ apiKey: "chk_live_YOUR_KEY" });
const result = await checkharbor.validateEmail("john.doe@gmail.com");
console.log(result.score, result.deliverability);
// 92 "deliverable"
```
pip install checkharbor
``````python
from checkharbor import Checkharbor
client = Checkharbor(api_key="chk_live_YOUR_KEY")
result = client.validate_email("john.doe@gmail.com")
print(result["score"], result["deliverability"])
# 92 deliverable
```
3. Check your credits
curl https://api.checkharbor.com/v1/ping \
-H "X-Api-Key: chk_live_YOUR_KEY"
{ "ok": true, "credits_remaining": 999 }