API Documentation

The TrustyMails API allows you to programmatically detect disposable email addresses in real-time. Integrate our API into your registration flow to prevent fraud and maintain a high-quality user base.

Base URL

https://api.trustymails.com/v1

Authentication

Authenticate your requests by including your API key in the header of each request. You can manage your API keys in the Dashboard.

Header

Authorization: Bearer YOUR_API_KEY

GET

/check

Verify a single email address or domain to check if it belongs to a disposable email provider.

Parameters

Name	Type	Description
email	string	The email address or domain to verify.

Example Request

cURL

curl -X GET "https://trustymails.com/api/mailinator.com" \
-H "Authorization:YOUR_API_KEY"

Example Response

200 OK

{
  "status": 200,
  "email": "[email protected]",
  "domain": "mailinator.com",
  "is_disposable": true,
  "is_mx_valid": true,
  "score": 0.1
}