Input Parameters - IP Enrichment API

Required Parameters

api_key

TypeDescriptionDefaultExample
StringYour secret API key.

Your API Key must be included in either the request header or the api_key parameter. For more information about request authentication, see the Authentication page.


ip

TypeDescriptionExample
StringThe IP address to enrich in IPv4 or IPv6 format.72.212.42.169

Optional Parameters

return_ip_location

TypeDescriptionDefaultExample
BooleanIP responses will not include location data for the IP by default. Setting return_ip_location to true will return IP specific location info regardless of a company match.falsetrue

return_ip_metadata

TypeDescriptionDefaultExample
BooleanIP responses will not include metadata for the IP by default. Setting return_ip_metadata to true will return IP specific metadata regardless of a company match.falsetrue

return_if_unmatched

TypeDescriptionDefaultExample
BooleanSetting return_if_unmatched to true will return IP specific metadata or location data regardless of a company match.falsetrue

return_person

TypeDescriptionDefaultExample
BooleanSetting return_person to true will return person fields associated with the IP.falsetrue

min_confidence

TypeDescriptionDefaultExample
Enum [String]Returns responses if they are equal to or higher confidence than the defined parameter. For example, setting min_confidence to high will only return responses if company.confidence and person.confidence is high or very high. See canonical values for a list of accepted values.high

pretty

TypeDescriptionDefaultExample
BooleanWhether the output should have human-readable indentation.falsetrue

titlecase

TypeDescriptionDefaultExample
BooleanAll text in API responses returns as lowercase by default. Setting titlecase to true will titlecase response data instead.falsetrue

updated_title_roles

TypeDescriptionDefaultExample
BooleanTemporary parameter. Set to true to return the updated taxonomy for job_title_role and job_title_subrole along with the new job_title_class field.falsetrue