IP Address
This API provides detailed information and security insights about a given IP address. It returns geolocation data such as the country, region, city, timezone, and coordinates, along with metadata indicating whether the IP is valid or belongs to a private or public range. Additionally, it includes a blacklist report that checks if the IP is associated with malicious activities like spam, proxy, VPN, Tor, or malware.
API Details
curl --location 'https://api.signzy.app/api/v3/ipAddress' \
--header 'Content-Type: application/json' \
--header 'Authorization: <Authorization Token>' \
--data '{
"ipAddress":" "
}'Request Body
{
"ipAddress": " "
}
Input Table
Parameter | Required | Type | Default | Description |
|---|---|---|---|---|
ipAddress | yes | string |
| An IPv4 or IPv6 address. Accepts standard IP notation and also CIDR notation |
Response Body
{
"error": {
"name": "error",
"message": "Error in getting data from Upstream",
"status": 409,
"reason": "ERROR",
"type": "Conflict",
"statusCode": 409
}
}Output Table
Parameter | Type | Description |
|---|---|---|
ip | string | The IPv4 or IPv6 address returned |
valid | boolean | True if this is a valid IPv4 or IPv6 address |
isV6 | boolean | True if this is an IPv6 address. False if IPv4 |
isV4Mapped | boolean | True if this is an IPv4-mapped IPv6 address |
isBogon | boolean | True if this is a bogon IP address such as a private network, local network, or reserved address |
country | string | Full country name |
countryCode | string | ISO 2-letter country code |
countryCode3 | string | ISO 3-letter country code |
continentCode | string | ISO 2-letter continent code |
currencyCode | string | ISO 4217 currency code associated with the country |
city | string | Full city name (if detectable) |
region | string | Full region name (if detectable) |
regionCode | string | ISO 3166-2 region code (if detectable) |
hostname | string | The IP's full hostname (PTR) |
hostDomain | string | The IP's host domain |
providerDomain | string | The domain name of the provider |
providerWebsite | string | The website URL for the provider |
providerDescription | string | A description of the provider (usually extracted from the provider’s website) |
providerType | string | The detected provider type (e.g. isp, hosting, vpn, proxy, university, government, commercial, unknown) |
isHosting | boolean | True if this IP belongs to a hosting company |
isIsp | boolean | True if this IP belongs to an internet service provider |
isVpn | boolean | True if this IP is a VPN |
isProxy | boolean | True if this IP is a proxy |
vpnDomain | string | The domain of the VPN provider (may be empty if not detectable) |
asn | string | The autonomous system (AS) number |
asCidr | string | The autonomous system (AS) CIDR range |
asCountryCode | string | The autonomous system (AS) ISO 2-letter country code |
asCountryCode3 | string | The autonomous system (AS) ISO 3-letter country code |
asDomains | array | Array of all the domains associated with the autonomous system (AS) |
asDescription | string | The autonomous system (AS) description or company name |
asAge | integer | The age of the autonomous system (AS) in number of years since registration |
timezone.id | string | Timezone identifier |
timezone.name | string | Full timezone name |
timezone.abbr | string | Timezone abbreviation |
timezone.date | string | Current date in timezone |
timezone.time | string | Current time in timezone |
timezone.offset | string | Timezone UTC offset |
latitude | number | Geographic latitude |
longitude | number | Geographic longitude |
ipBlacklist.ip | string | Blacklist check IP |
ipBlacklist.cidr | string | Blacklist CIDR |
ipBlacklist.lastSeen | integer | Last seen timestamp |
ipBlacklist.isHijacked | boolean | True if hijacked |
ipBlacklist.isSpider | boolean | True if web crawler/spider |
ipBlacklist.isTor | boolean | True if Tor exit node |
ipBlacklist.isDshield | boolean | True if Dshield listed |
ipBlacklist.isVpn | boolean | True if VPN detected |
ipBlacklist.isSpyware | boolean | True if spyware detected |
ipBlacklist.isSpamBot | boolean | True if spambot detected |
ipBlacklist.isBot | boolean | True if automated bot |
ipBlacklist.isListed | boolean | True if listed in any blacklist |
ipBlacklist.isProxy | boolean | True if proxy detected |
ipBlacklist.isMalware | boolean | True if malware source |
ipBlacklist.isExploitBot | boolean | True if exploit bot |
ipBlacklist.blocklists | array | List of blocklists |
ipBlacklist.listCount | integer | Number of blocklists |
ipBlacklist.sensors | array | Sensors that detected the IP |
Status Code:
Code | status | Description |
|---|---|---|
200 | Success | The request id was successfully generated. |
400 | Bad Request | Invalid input data |
409 | Upstream Error | Error in fetching data from upstream. |
500 | Internal Server Error | Something is broken. This is usually a temporary error, for example in a high-load situation.or if an endpoint is temporarily having issues. Try again later. |
Contact Us for Any Assistance
If you have any questions or need assistance, please reach out to our customer support team. You can contact us via email at [email protected]. We strive to provide prompt and reliable assistance, ensuring your queries are addressed effectively.
We value your feedback and are committed to making your experience smooth and enjoyable. Our team is dedicated to assisting you with any needs you may have. Thank you for choosing our services. We look forward to helping you!