truval
v0.2.1
Published
Email verification API client for AI agents
Downloads
88
Maintainers
Readme
truval
Email verification API client for AI agents.
Installation
npm install truvalUsage
import { verify, createClient } from 'truval'
// One-off verification
const result = await verify('[email protected]', process.env.TRUVAL_API_KEY!)
console.log(result.valid) // true
console.log(result.confidence) // 0.97
console.log(result.status) // 'deliverable'
// Client instance
const truval = createClient(process.env.TRUVAL_API_KEY!)
const result = await truval.verify('[email protected]')Response
| Field | Type | Description |
|---|---|---|
| valid | boolean | true if the address passed all checks |
| status | string | deliverable · undeliverable · unknown · catch_all · invalid |
| confidence | number | 0–1 confidence score |
| disposable | boolean | throwaway domain |
| role | boolean | admin@, info@, noreply@ etc |
| smtp_blocked | boolean | Gmail/Outlook/Yahoo block SMTP probing — expected |
| suggestion | string|null | typo correction e.g. "gmail.com" |
