API Format

Base URL

Singapore: <https://sg.apitd.net/verification/persona/email/pro/v1>
America: <https://us.apitd.net/verification/persona/email/pro/v1>
Germany: <https://de.apitd.net/verification/persona/email/pro/v1>

API

URL	Request Methods	Content-Type	Output Format	Character Set
api-base-url?partner_code=xxx&partner_key=xxx	POST	application/json	JSON	UTF-8

example: <https://sg.apitd.net/verification/persona/email/pro/v1?partner_code=test_code&partner_key=test_key>

Authentication

Parameter	Type	Description	Required/Optional	Notes
partner_code	String	Partner Code	required	assigned by TD
partner_key	String	Partner Key	required	assigned by TD

Request

Parameter	Type	Description	Required/Optional	Notes
email	String	Email Address	required

Request Example

{
    "email": "hello@gmail.com"
}

Response Parameter

Parameter	Type	Description	Notes
code	Integer	API Status Code
message	String	Status Message	specific abnormal reasons will be provided if the API is abnormal
sequence_id	String	Unique ID of Response	A unique ID used to mark each request
status	String	Email Status	enumeration: valid, invalid, abuse, unknown
risk_labels	Array	Risk Label	suspicious, temporary, random, similar
free_mail	String	Free Mail Status	enumeration: free, paid, unknown
risk_score	Integer	Risk Score	range: 0 - 100

API Status Code

code	Description
200	Success
301	Service not purchased
302	Traffic blocked
303	Traffic insufficient
304	Service expired
305	Daily maximum volume reached
9600	System error
9606	Illegal parameter

Response Example

{
  "code": 200,
  "message": "",
  "sequence_id": "1648777165770866F82AC7F326307055",
  "status": "invalid",
  "risk_labels": ["suspicious"],
  "free_mail": "free",
  "risk_score": 100
}