ClearAddress API

The ClearAddress API provides a simple way to validate email addresses.

Email Validation

GET https://ca.rda.run/v1/{email_address}?pretty (validate one email address)

Parameters

name	type	data type	description
email_address	required	string	The specific email address to test.
pretty	optional	flag	If present, the response will be formatted for human readability.

Responses

http code	content-type	response
200	application/json;charset=UTF-8	JSON string
400	application/json	{"code":"400","message":"Bad Request"}

Response Fields

field	type	description
email	string	The email address being validated.
localPart	string	The local part of the email address.
domain	string	The domain part of the email address.
hasValidDomain	boolean	Indicates if the domain is valid.
hasValidMX	boolean	Indicates if the domain has valid MX records.
hasValidSyntax	boolean	Indicates if the email has valid syntax.
isFunctional	boolean	Indicates if the email is functional.
isDisposable	boolean	Indicates if the email is disposable.
isClear	boolean	Indicates if we consider the email "clear": with a existing domain, with valid MX records, with valid syntax, not from a functional mailbox, and not from a disposable email service.

cURL Example

 curl -fsSL "https://ca.rda.run/v1/user@example.org?pretty"

Response Example

 {
   "email": "user@example.org",
   "localPart": "user",
   "domain": "example.org",
   "hasValidDomain": true,
   "hasValidMX": true,
   "hasValidSyntax": true,
   "isFunctional": true,
   "isDisposable": false,
   "isClear": false
 }