Email Intelligence - Extended response - Submit an email address to evaluate

post

https://detect.telesign.com/intelligence/email

Obtain a risk recommendation for this email address, as well as other relevant information using the Telesign Cloud API. In addition to the standard response, see the Standard Response Reference. You may also request extended response elements, which provide additional context beyond what is returned by default.

The extended response includes optional Phone number details (location, numbering information, phone type, carrier, and blocklisting status) and additional Domain details, which expand on the standard domain information by including domain tenure, registrant attributes, and registrar information. These extended response elements are available only when explicitly requested and are not enabled by default. To enable access to these extended response fields, please contact your Telesign account manager for further information.

General requirements

Authentication: Basic (easiest to implement) or Digest
Encoding: Accepts only UTF-8 unicode characters as inputs.
Accepts: application/x-www-form-urlencoded
Responds with: application/json
Required headers: Content-Type - application/x-www-form-urlencoded
Rate limit: Default rate limits by product

Recent Requests

Time	Status	User Agent
Retrieving recent requests…

Loading…

Form Data

email_address

string

required

Your end user's email address. This value is case sensitive.

account_lifecycle_event

string

enum

required

The attempted action associated with this email address for which you want to evaluate the risk. Acceptable values for this parameter are -

create - For the creation of a new account.
sign-in - For when an end user signs in to their account.
transact - For when an end user completes a transaction within their account.
update - For when an update is performed, such as an update of account information or similar.
delete - For when an account is deleted.

Allowed:

account_id

string

Your end user's account ID. This value is case sensitive.

phone_number

string

Your end user's phone number.

device_id

string

Your end user's device ID. This value is case sensitive.

external_id

string

Any ID passed from you that can uniquely identify this transaction in your system. The response simply echoes the value provided for this parameter.

originating_ip

string

Your end user's IP address (do not send your own IP address). IPv4 and IPv6 are supported. For IPv4, the value must be in the format defined by the Internet Engineering Task Force (IETF) in the Internet-Draft document titled Internet Protocol. For IPv6, the value must be in the format defined by the IETF in the Internet-Draft document titled IP Version 6 Addressing Architecture.

Responses

Status Code	Associated Text String	Description
300	Transaction successfully completed	The system was able to obtain all of the requested data.
301	Transaction partially completed	The system was able to obtain some of the data, but not all of it.

Status Code	Associated Text String
10032	Request blocked due to this number appearing on a TeleSign blocklist.
10033	Unverified phone_number requested for trial account.
11000	Invalid value for parameter phone_number
11001	Invalid country code for parameter phone_number
11002	Invalid value for parameter account_id
11003	Invalid value for parameter account_lifecycle_event
11005	Invalid value for parameter customer_id
11006	Invalid value for parameter device_id
11007	Invalid value for email_address
11010	Invalid value for parameter originating_ip
11011	Invalid value for parameter reference_id
12000	Missing required parameter phone_number
12003	Missing required parameter account_lifecycle_event

Status Code	Associated Text String
10008	Invalid signature
10009	Invalid value for parameter message
10010	Invalid value for parameter originating_ip
10011	Invalid value for parameter reference_id
10012	This feature is not enabled for this CustomerID
10013	Invalid Request. CustomerID Account Not Found
10014	Invalid source IP address
10015	Invalid customer ID

Status Code	Associated Text String
10019	Rate Limit Exceeded
10020	PhoneId Standard exceeded transaction hard cap. Request denied.

402Payment Required. If you want to code against a response, you should retrieve the status or error code and use that rather than the HTTP status response. Status CodeAssociated Text String10030Insufficient funds in prepaid wallet

404Not Found. The server has not found anything matching the Request-URI. If you want to code against a response, you should retrieve the status or error code and use that rather than the HTTP status response. Status CodeAssociated Text String10017Customer ID / Reference ID not found

500Invalid Transaction. Transaction not attempted.

503Service Unavailable. System unavailable, try again.