This product is applicable for social network/media registration and information detection.
API Method
Base URL
- Indonesia: https://id.apitd.net/verification/kyc/emailverify/v1
- Singapore: https://sg.apitd.net/verification/kyc/emailverify/v1
- Pakistan: https://pk.apitd.net/verification/kyc/emailverify/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 |
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 |
|---|---|---|---|---|
| id_number | String | ID number | Strongly recommended | ID number |
| id_type | String | ID type | Strongly recommended | Enumeration value: 1. identity_card: ID card 2. passport: passport 3. driving_licence: driving license 4. birth_certificate: birth certificate 5. voter_card: Voter card 6. tax_card: tax card 7. social_security_card: social security card 8. others: others |
| phone_number | String | Phone number | Strongly recommended | The maximum length is 19 digits, with country code, for example: 36301234567. If filled in, it must match with the country. |
| name | String | Name | Strongly recommended | |
| country | String | Country | Required | 2-letter country code according to ISO 3166 Pakistan site only supports PK, Indonesia site only supports ID |
| String | Required | Email address, i.e.[email protected] |
Request Example
{
"country":"ID",
"phone_number":"36301234567",
"id_type":"identity_card",
"id_number":"3310225629467",
"name":"Joe",
"email":"[email protected]"
}
Response Parameter
| Parameter | Type | Description | Required/Optional | Notes |
|---|---|---|---|---|
| code | Integer | API status code | Required | |
| message | String | Status Information | Required | Apecific abnormal reasons will be provided when the API is abnormal |
| sequence_id | String | Unique response code | Required | A unique ID used to track each request |
| email_detection | Object | Detection result | Required | |
| basic_info | Object | Basic Information | Required | |
| domain_info | Object | Domain Information | Required | |
| account_info | Object | Account Information | Required | |
| breach_info | Object | Breach Information | Required | |
| history_info | Object | History Information | Required |
- basic_info data dictionary
| Parameter | Type | Description | Required/Optional | Notes |
|---|---|---|---|---|
| email_address | String | Email Address | Required | |
| score | String | The possibility of fraud with this email, the higher the score, the higher the risk | Required | Range: 0-999 |
| existence | Boolean | Whether the mail actually exists | Required | |
| created_time | String | Created time | Required | |
| updated_time | String | Updated time | Required | |
| expires_time | String | Expired time | Required | |
| registered_to | String | The name of the company registered by this mail | Required |
- domain_info data dictionary
| Parameter | Type | Description | Required/Optional | Notes |
|---|---|---|---|---|
| dmarc_enforced | Boolean | Is it mandatory DMARC | Required | |
| spf_strict | Boolean | This field shows whether SPF strict is enough to prevent spoofing | Required | |
| valid_mx | Boolean | This field shows whether the domain's MX record is valid or not | Required | |
| accept_all | Boolean | Whether the server is set up to accept all email from this domain. | Required | |
| tld_suspicious | Boolean | Whether top-level domains may be fraudulent and risky. | Required | |
| website_exists | Boolean | Whether the domain of the email has a website | Required |
- account_info data dictionary
| Parameter | Type | Description | Required/Optional | Notes |
|---|---|---|---|---|
| total_registered | Int | Total number of registrations | Required | |
| registration_detail | Array | Registration detail | Required |
- registration_detail data dictionary
| Parameter | Type | Description | Required/Optional | Notes |
|---|---|---|---|---|
| account_type | String | The detected social networking sites | Required | The detected social networking sites are as follows:facebook, google, apple, twitter, microsoft, yahoo, ebay, gravatar, instagram, spotify, tumblr, linkedin, weibo, github, vimeo, flickr, foursquare, lastfm, myspace, pinterest, skype, discord, ok, kakao, booking, airbnb, amazon, qzone , Adobe, mailru, wordpress, imgur, disneyplus, netflix, jdid, flipkart, bukalapak, archiveorg, lazada, zoho, samsung, evernote, envato, patreon, tokopedia, rambler, quora, atlassian |
| registered | Boolean/Int | whether registered | Required | |
| account_name | String/Int | Account name | Conditionally Required | Only appears on: facebook, linkedin, skype, gravatar |
| account_username | String/Int | Username | Conditionally Required | Only appears on:Flickr, gravatar, github |
| profile_photo | String/Int | Photo | Conditionally Required | Only appears on: facebook, google, linkedin, skype, foursquare, github, flickr; imgae only appears on:airbnb |
| profile_url | String/Int | Url | Conditionally Required | Only appears on: facebook, linkedin, gravatar, foursquare,github |
| profile_company | String/Int | Company | Conditionally Required | Only appears on: linkedin, github |
| profile_title | String/Int | Company positions | Conditionally Required | Only appears on: linkedin |
| profile_bio | String/Int | Bio information | Conditionally Required | Only appears on: foursquare, skype, github |
| profile_website | String/Int | Website | Conditionally Required | Only appears on:LinkedIn |
| profile_handle | String/Int | Handle | Conditionally Required | Only appears on:Skype |
| account_location | String/Int | The location of the account | Conditionally Required | Only appears on:linkedin, aribnb, gravatar, flickr, github |
| account_country | String/Int | The country of the account | Conditionally Required | Only appears on:skype |
| account_city | String/Int | The city where the account is located | Conditionally Required | Only appears on: skype, ok |
| account_state | String/Int | The state where the account is located | Conditionally Required | Only appears on:skype |
| account_language | String/Int | The language the account used | Conditionally Required | Only appears on: skype |
| account_twitter | String/Int | Twitter connected with | Conditionally Required | Only appears on:LinkedIn, github |
| profile_gender | String/Int | Gender | Conditionally Required | Only appears on: skype,1: Male;2: Female |
| profile_age | String/Int | Age | Conditionally Required | Only appears on: skype, ok |
| profile_id | String/Int | Profile ID | Conditionally Required | Only appears on: Skype |
| account_joined_date | String/Int | Account join time | Conditionally Required | Only appears on: ok |
| connection_count | String/Int | Verification state based on the profile settings. | Conditionally Required | Only appears on:linkedin |
| reviewee_count | String/Int | Count of reviewees on the profile. | Conditionally Required | Only appears on:Airbnb |
| trips | String/Int | Count of trips on the profile. | Conditionally Required | Only appears on:Airbnb |
| profile_firstname | String/Int | First name | Conditionally Required | Only appears on:Airbnb |
| profile_work | String/Int | Workplace name based on the profile settings. | Conditionally Required | Only appears on:Airbnb |
| profile_identity_verified | String/Int | Verification state based on the profile settings. | Conditionally Required | Only appears on:Airbnb |
- breach_info data dictionary
| Parameter | Type | Description | Required/Optional | Notes |
|---|---|---|---|---|
| breach_detail | Object | Breach Detail | Required | |
| breach_platform | String | Email leaked platform | Optional | Only returned while the email has breach info. |
| breach_domain | String | Email leaked domains | Optional | Only returned while the email has breach info. |
| breach_date | String | Date the email was leaked | Optional | Only returned while the email has breach info. |
| pwned_list | Boolean | Whether email addresses were compromised in a data breach. | Required | |
| breach_number | Int | Number of leaks | Required | |
| breach_first_time | String | First time of leak | Required |
- history_info data dictionary
| Parameter | Type | Description | Required/Optional | Notes |
|---|---|---|---|---|
| hits_time | Int | The number of times this email has been queried in our company | Required | |
| customer_hits_time | Int | Query the number of customers of this email (remove duplicates) | Required | |
| first_seen | Int | The first time any client looks up this email in UNIX time format and UTC time zone, without milliseconds. | Required | |
| last_seen | Int | The last time any client looked up this email in UNIX time format and UTC timezone, without milliseconds. | Required |
API Status Code
| Code | Message | Description | Charged |
|---|---|---|---|
| 200 | success | Success | YES |
| 300 | Service not purchased or not effective | Service not purchased or not effective | NO |
| 301 | Service not purchased | Service not purchased | NO |
| 302 | Traffic blocked | Traffic blocked | NO |
| 303 | Traffic insufficient | Traffic insufficient | NO |
| 304 | Service expired | Service expired | NO |
| 305 | Daily maximum volume reached | Daily maximum volume reached | NO |
| 600 | Service Temporarily Unavailable | Service reached limit | NO |
| 11350 | Internal error | Internal error | NO |
| 11301 | {parameter} empty | {parameter} empty | NO |
| 11304 | The country partner located is not open | The country partner located is not open | NO |
| 11340 | {parameter} error | {parameter} error | NO |
Response Example-Success
{
"code": 200,
"email_detection": {
"basic_info": {
"created_time": "1995-08-13 04:00:00",
"updated_time": "2023-07-11 10:10:13",
"email_address": "[email protected]",
"existence": true,
"registered_to": "Google LLC",
"expires_time": "2024-08-12 04:00:00",
"score": "150.0"
},
"breach_info": {
"breach_detail": [
{
"breach_date": "2020-04-17",
"breach_domain": "tokopedia.com",
"breach_platform": "Tokopedia"
}
],
"breach_number": 1,
"pwned_list": true,
"breach_first_time": "2020-04-17"
},
"account_info": {
"total_registered": 11,
"registration_detail": [
{
"account_type": "booking",
"registered": true
},
{
"account_type": "lazada",
"registered": false
},
{
"account_type": "lastfm",
"registered": false
},
{
"account_type": "wordpress",
"registered": false
},
{
"account_type": "instagram",
"registered": false
},
{
"account_type": "tokopedia",
"registered": true
},
{
"account_type": "microsoft",
"registered": true
},
{
"account_type": "airbnb",
"account_location": -999,
"profile_work": -999,
"profile_photo": -999,
"reviewee_count": -999,
"trips": -999,
"registered": -999,
"profile_identity_verified": -999,
"profile_firstname": -999
},
{
"account_type": "envato",
"registered": false
},
{
"account_type": "twitter",
"registered": false
},
{
"account_type": "yahoo",
"registered": false
},
{
"account_type": "github",
"account_location": -999,
"account_twitter": -999,
"profile_photo": -999,
"profile_url": -999,
"account_username": -999,
"registered": false,
"profile_website": -999,
"profile_bio": -999,
"profile_company": -999
},
{
"account_type": "archiveorg",
"registered": false
},
{
"account_type": "atlassian",
"registered": true
},
{
"account_type": "google",
"profile_photo": -999,
"registered": -999
},
{
"account_type": "patreon",
"registered": true
},
{
"account_type": "rambler",
"registered": false
},
{
"account_type": "amazon",
"registered": -999
},
{
"account_type": "mailru",
"registered": false
},
{
"account_type": "discord",
"registered": true
},
{
"account_type": "ebay",
"registered": -999
},
{
"account_type": "bukalapak",
"registered": -999
},
{
"account_type": "zoho",
"registered": false
},
{
"account_type": "foursquare",
"profile_photo": -999,
"profile_url": -999,
"registered": -999,
"profile_bio": -999
},
{
"account_type": "tumblr",
"registered": false
},
{
"account_type": "linkedin",
"account_location": -999,
"account_twitter": -999,
"profile_title": -999,
"profile_photo": -999,
"profile_url": -999,
"connection_count": -999,
"account_name": -999,
"registered": -999,
"profile_website": -999,
"profile_company": -999
},
{
"account_type": "netflix",
"registered": false
},
{
"account_type": "myspace",
"registered": false
},
{
"account_type": "apple",
"registered": false
},
{
"account_type": "skype",
"account_language": -999,
"profile_photo": -999,
"profile_gender": -999,
"registered": false,
"profile_bio": -999,
"profile_handle": -999,
"profile_age": -999,
"profile_id": -999,
"account_name": -999,
"account_city": -999,
"account_country": -999,
"account_state": -999
},
{
"account_type": "kakao",
"registered": -999
},
{
"account_type": "samsung",
"registered": true
},
{
"account_type": "weibo",
"registered": false
},
{
"account_type": "quora",
"registered": true
},
{
"account_type": "gravatar",
"account_location": -999,
"profile_url": -999,
"account_name": -999,
"account_username": -999,
"registered": false
},
{
"account_type": "evernote",
"registered": false
},
{
"account_type": "imgur",
"registered": false
},
{
"account_type": "ok",
"profile_age": -999,
"registered": false,
"account_city": -999,
"account_joined_date": -999
},
{
"account_type": "disneyplus",
"registered": false
},
{
"account_type": "jdid",
"registered": -999
},
{
"account_type": "facebook",
"profile_photo": -999,
"profile_url": -999,
"account_name": -999,
"registered": false
},
{
"account_type": "spotify",
"registered": true
},
{
"account_type": "flipkart",
"registered": false
},
{
"account_type": "adobe",
"registered": true
},
{
"account_type": "pinterest",
"registered": true
},
{
"account_type": "qzone",
"registered": false
},
{
"account_type": "vimeo",
"registered": false
},
{
"account_type": "flickr",
"account_location": -999,
"profile_photo": -999,
"account_username": -999,
"registered": false
}
]
},
"domain_info": {
"tld_suspicious": false,
"spf_strict": true,
"website_exists": true,
"valid_mx": true,
"accept_all": false,
"dmarc_enforced": true
},
"history_info": {
"first_seen": 1681768896,
"last_seen": 1705384608,
"hits_time": 18,
"customer_hits_time": 3
}
},
"sequence_id": "1705384917350000XA84A005A753****",
"message": "success"
}
Response Example-Failed
{
"code": 11340,
"sequence_id": "1720072040470369I30BC3538833****",
"message": "Country error"
}