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!