Digital Integrity check API
The Digital Integrity Check API provides a comprehensive solution for validating key user data, enhancing security, and reducing fraud.
Our API offers the following core functionalities:
- Email Validation: The API verifies the existence, format, and provider of email addresses. It identifies whether the email is from a free provider like Gmail, checks for typos, and detects disposable or personal email addresses.
- Phone Validation: This feature confirms the validity and format of phone numbers, identifying the country, network provider, and phone type (mobile or landline).
- IP Blocklist Check: Identify and flag IP addresses listed on known blocklists, helping to prevent interactions with malicious or suspicious sources. It checks if the IP is associated with hijacking, bots, proxies, and other risky behaviors.
- IP Information: Obtain detailed information about IP addresses, including geolocation, ISP details, and connection type. This helps gain insights into the origin of user traffic.
By integrating the Digital Integrity Check API, businesses can enhance their data quality, protect against fraudulent activities, and ensure secure and reliable communication with their users.
API Endpoint
UAT/Testing
POST https://api-preproduction.signzy.app/api/v3/validity/digitalIntegrityProduction
POST https://api.signzy.app/api/v3/validity/digitalIntegrityHeaders
Key | Value |
|---|---|
Authorization | access token (returned as id field of login request) |
Content-type | application/json |
Request Body
The API request should include the following data in the request body:
{
"email" : "ronit7**[email protected]",
"ip" : "103.1*7.203.228",
"phone" : "776****399"
}Field | Description |
|---|---|
Email ID to be checked | |
ip | This is the IP address to be checked. |
phone | Phone number to be checked ( with country code, in case it is not provided then it will pick the first two digits as country code) |
Response
The API response will be in the following format:
{
"result": {
"emailResult": {
"valid": false,
"provider": "",
"domainError": false,
"domain": "gmailm",
"isFreemail": false,
"syntaxError": true,
"email": "ronit7577@gmailm",
"isDisposable": false,
"isPersonal": true
},
"phoneValidate": {
"valid": true,
"country": "India",
"countryCode": "IN",
"countryCode3": "IND",
"prefixNetwork": "Airtel",
"internationalNumber": "+917761806399",
"type": "mobile",
"currencyCode": "INR",
"internationalCallingCode": "91",
"isMobile": true
},
"ipBlacklist": {
"ip": "103.177.203.228",
"cidr": "103.177.203.228/32",
"lastSeen": 1718432098,
"isHijacked": false,
"isSpider": false,
"isTor": false,
"isDshield": false,
"isVpn": false,
"isSpyware": false,
"isSpamBot": false,
"isBot": false,
"isListed": true,
"isProxy": true,
"isMalware": false,
"isExploitBot": false,
"blocklists": [
"proxy"
],
"listCount": 1,
"sensors": [
{
"blocklist": "proxy",
"description": "Public HTTP proxy",
"id": 53
}
]
},
"ipInfo": {
"valid": true,
"ip": "103.177.203.228",
"city": "Noida",
"regionCode": "IN",
"region": "UP",
"country": "India",
"countryCode": "IN",
"countryCode3": "IND",
"currencyCode": "INR",
"continentCode": "AS",
"isBogon": false,
"isV6": false,
"isV4Mapped": false,
"hostname": "",
"hostDomain": "",
"timezone": {
"date": "19/06/2024",
"offset": "+05:30",
"name": "India Standard Time",
"id": "Asia/Kolkata",
"time": "11:03:11.863527",
"abbr": "IST"
},
"latitude": 28.579891,
"longitude": 77.329865
}
}
}Response body parameters
Field | Description |
|---|---|
result | Object |
result.emailResult | Object |
result.emailResult.valid | Is this a valid email address? To be valid, an email must have correct syntax, a registered and active domain name, proper DNS records, and operational MX servers. "true/false" |
result.emailResult.provider | Domain name of the email hosting provider |
result.emailResult.domainError | True if this address has domain name or DNS errors |
result.emailResult.domain | The domain name of this email address |
result.emailResult.isFreemail | True if this address is from a free email provider |
result.emailResult.syntaxError | True if this address has syntax errors or is not RFC compliant |
result.emailResult.email | The complete email address |
result.emailResult.isDisposable | True if this address is a disposable, temporary or darknet related email address |
result.emailResult.isPersonal | True if this address likely belongs to a person. False if this is a role-based address, e.g., admin@, help@, office@, etc. |
result.phoneValidate | Object |
result.phoneValidate.valid | Is this a valid phone number |
result.phoneValidate.country | The phone number country |
result.phoneValidate.countryCode | The phone number country as an ISO 2-letter country code |
result.phoneValidate.countryCode3 | The phone number country as an ISO 3-letter country code |
result.phoneValidate.prefixNetwork | The network/carrier who owns the prefix (this only works for some countries, use HLR lookup for global network detection) |
result.phoneValidate.internationalNumber | The number represented in full international format (E.164) |
result.phoneValidate.type | The number type based on the number prefix. Possible values are: mobile, fixed-line, premium-rate, toll-free, voip, unknown (use HLR lookup) |
result.phoneValidate.currencyCode | ISO 4217 currency code associated with the country |
result.phoneValidate.internationalCallingCode | The international calling code |
result.phoneValidate.isMobile | True if this is a mobile number. If the number type is unknown this value will be false |
result.ipBlacklist | Object |
ipBlacklist.ip | The IP address |
ipBlacklist.cidr | The CIDR address for this listing (only set if the IP is listed) |
ipBlacklist.lastSeen | When this IP was last seen on any blocklist. IPs are automatically removed after 7 days, therefore this value will never be older than 7 days |
result.ipBlacklist.isHijacked | IP is part of a hijacked netblock or a netblock controlled by a criminal organization. "True/False" |
ipBlacklist.isSpider | IP is running a hostile web spider/web crawler |
ipBlacklist.isTor | IP is a Tor node or running a Tor-related service |
ipBlacklist.isDshield | IP has been flagged as a significant attack source by DShield (dshield.org) |
ipBlacklist.isVpn | IP belongs to a public VPN provider |
ipBlacklist.isSpyware | IP is involved in distributing or is running spyware |
ipBlacklist.isSpamBot | IP address is hosting a spam bot, comment spamming, or any other spamming type software |
ipBlacklist.blocklists | An array of strings indicating which blocklist categories this IP is listed on |
ipBlacklist.isBot | IP is hosting a malicious bot or is part of a botnet. This is a broad category that includes brute-force crackers |
ipBlacklist.sensors | An array of objects containing details on which specific sensors detected the IP: |
ipBlacklist.sensors.id | The sensor ID. This is a permanent and unique ID for each sensor (Integer) |
ipBlacklist.sensors.blocklist | The primary blocklist category this sensor belongs to (String) |
ipBlacklist.sensors.description | Contains details about the sensor source and what type of malicious activity was detected (String) |
ipBlacklist.listCount | The number of blocklists the IP is listed on |
ipBlacklist.isListed | Is this IP on a blocklist |
ipBlacklist.isProxy | IP has been detected as an anonymous web proxy or anonymous HTTP proxy |
ipBlacklist.isMalware | IP is involved in distributing or is running malware |
ipBlacklist.isExploitBot | IP is hosting an exploit-finding bot or is running exploit scanning software |
ipInfo | Object |
ipInfo.regionCode | ISO 3166-2 region code (if detectable) |
ipInfo.country | Country name |
ipInfo.countryCode | ISO 2-letter country code |
ipInfo.city | Name of the city (if detectable) |
ipInfo.timezone | Map containing timezone details for the location (Object) |
ipInfo.timezone.date | The current date at the time zone (ISO 8601 format 'YYYY-MM-DD') |
ipInfo.timezone.offset | The UTC offset for the time zone (ISO 8601 format '±hh:mm') |
ipInfo.timezone.name | The full time zone name |
ipInfo.timezone.id | The time zone ID as per the IANA time zone database (tzdata) |
ipInfo.timezone.time | The current time at the time zone (ISO 8601 format 'hh:mm:ss.sss') |
ipInfo.timezone.abbr | The time zone abbreviation |
ipInfo.ip | The IPv4 or IPv6 address returned |
ipInfo.latitude | Location latitude |
ipInfo.valid | True if this is a valid IPv4 or IPv6 address |
ipInfo.isV4Mapped | True if this is a IPv4 mapped IPv6 address |
ipInfo.hostname | The IP's full hostname (only set if reverse-lookup has been used) |
ipInfo.continentCode | ISO 2-letter continent code |
ipInfo.hostDomain | The IP's full hostname (only set if reverse-lookup has been used) |
ipInfo.currencyCode | ISO 4217 currency code associated with the country |
ipInfo.region | Name of the region (if detectable) |
ipInfo.isBogon | True if this is a bogon IP address such as a private network, local network, or reserved address |
ipInfo.countryCode3 | ISO 3-letter country code |
ipInfo.isV6 | True if this is a IPv6 address. False if IPv4 |
ipInfo.longitude | Location longitude |