--- title: "Enrich Company IP Address" method: GET path: "/v1/ip/enrich" tags: ["IP", "v1"] --- # Enrich Company IP Address `GET /v1/ip/enrich` Enriches an input IP (IPv4/IPv6) with matching company information (if any). **Note:** - This endpoint requires an active subscription to the IP Enrich product. - A request will only be counted as a successful match when the `company_type` attribute is set to `company`. :::info Requires the `ip:read` OAuth2 scope. ::: ## Query parameters - `ip` string, required - `account_id` string, required ## Response `200` Success - object - `data` EnrichedIpV1, required - `type` 'enriched_ip', required — The type of the object - `id` string, required - `attributes` object, required - `ip_address` string, required — The IP address - `company_type` 'shared_network' | 'company', required — Indicates whether the IP address is associated with a company or another entity (e.g. an ISP). - `confidence_score` 'very_high' | 'high' | 'medium' | 'low', required — The confidence score of the IP address. - `location` IpLocationV1, required - `type` 'ip_location', required — The type of the object - `id` string, required — The unique identifier for the location. - `attributes` object, required - `city` string, nullable, required — The city name. - `region` string, nullable, required — The region or state name. - `country_code` string, required — The ISO 3166-1 alpha-2 country code. - `geonames_id` string, nullable, required — The GeoNames ID. - `relationships` union, required - object - `company` CompanyV1, required - `type` 'company', required — The type of the object - `id` string, required — The Leadfeeder company ID. - `attributes` object, required - `address` object, required - … - `alternative_names` string[], required — An array of alternate / previous spellings of the company name. - `alternative_urls` string[], required — A set of alternative URLs related to the company. - `custom_fields` object, required — A dictionary of custom field values, indexed by their unique field IDs. - `description` string, nullable, required — A text containing information about the company (native language) - `earnings` object, nullable, required - … - `emails` object[], required — Email address(es) for the company (eg. info@, service@ or support@). - … - `employee_count` integer, nullable, required — The currently known headcount for this company. - `employee_range` '1-10' | '11-100' | '101-500' | '501-1.000' | '1.001-5.000' | '5.001-10.000' | '10.000+' | 'null', nullable, required — A range indicator of the approximate headcount for this company. - `founded_year` integer, nullable, required — A number representing the year when the company was founded. - `industries` object, required — A list of the company's industries. - … - `keywords` string[], required — An array of keywords about the company and its products that have been extracted from the website. They will be returned in your user's language. - `legal_form` string, nullable, required — The company's legal form (i.e. GmbH, SARL or Limited). - `logo_url` string, uri, nullable, required — The URL of the company's logo. - `meta` object, required - … - `name` string, required — The legal name of the company - `net_worth` object, nullable, required - … - `orientation` string[], required — The target audience(s) of the company. The value 'B2B' indicates that the company is primarily focused on business customers, while 'B2C' indicates a focus on individual consumers. The value 'OTHER' means it’s a public (likely non-commercial) service or institution. - `phones` object[], required — The central phone number(s) of the company. - … - `previous_ids` string[], required — A list of former ids that the company was known by in the past. The ID may have changed for example due to a merger with another company. The list is empty if there are no previous IDs. - `register` object, required - … - `revenue` object, nullable, required - … - `role` 'single_entity' | 'group' | 'group_member' | 'null', nullable, required — This field indicates the role of the company within its group structure. - `social_media_profiles` object, required — List of social media pages. - … - `url` string, nullable, required — The URL of the company website. - `vat_id` string, nullable, required — The company's VAT ID (tax ID). - `web_engagement` object, required — Web engagement data for a company. - … - `intent` object, required - … - `relationships` object, required - `group_company` union, required — The group company head. The field may be null if the company is a single entity. By default this field only contains the `id` and `type` fields, but you can load all company attributes by passing the `include=group_company` url parameter. - … - `tags` TagV1[] — Tags assigned to the company. By default this field is not displayed, but you can load it by passing the `include=tags` url parameter. - … - `lists` ListV1[] — Lists that include this company. By default this field is not displayed, but you can load it by passing the `include=lists` url parameter. - … - `web_visits` WebVisitV1[] — Web visits associated with the company. It returns first 20 visits from last 7 days. By default this field is not displayed, but you can load it by passing the `include=web_visits` url parameter. - … - `crm_connections` CRMConnectionV1[] — CRM connections associated with the company. By default this field is not displayed, but you can load it by passing the `include=crm_connections` url parameter. - … - `crm_suggestions` CRMSuggestionV1[] — CRM suggestions associated with the company. By default this field is not displayed, but you can load it by passing the `include=crm_suggestions` url parameter. - … - `crm_group_connections` CRMGroupConnectionV1[] — CRM group connections associated with the company. By default this field is not displayed, but you can load it by passing the `include=crm_group_connections` url parameter. - … - `icps` ICPV1[] — Ideal Customer Profiles (ICPs) defined in the account that this company matches. By default this field is not displayed, but you can load it by passing the `include=icps` url parameter. - … - object - `network` NetworkV1, required - `type` 'network', required — The type of the object - `id` string, required — The network's IP address - `attributes` object, required - `name` string, required — The network name - `meta` object, required - `num_results` integer, required — Set to 1 if the request is considered successful. Otherwise, it is set to 0. - `request_id` string, required — A unique identifier assigned to each API request for end-to-end traceability. ## Other responses - `400` — Invalid mandatory fields - `401` — Unauthorized. The request was rejected because the credentials are missing, invalid, expired, or have been revoked. The client must re-authenticate before retrying. Clients can differentiate via the `code` value of the first item in `errors`. - `403` — Forbidden. The credentials are valid but the caller is not authorized to perform the request — typically because the user lacks the required permission, the OAuth scope is insufficient, the subscription plan does not include the required entitlement, the `account_id` does not belong to the authenticated user, or the target list is read-only and its members cannot be modified. Clients can differentiate via the `code` value of the first item in `errors`. - `429` — Too many requests. Either the per-second rate limit or the monthly quota configured for the API key / OAuth application has been exceeded. Clients can differentiate via the `code` value of the first item in `errors`. - `500` — Internal server error - `504` — Server timeout --- [API](https://skmtc.net/leadfeeder/apis/leadfeeder-public-api.md) · [All operations](https://skmtc.net/leadfeeder/apis/leadfeeder-public-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadfeeder/leadfeeder-public-api/revisions/9e2e63ba2a4e/schema)