--- title: "Retrieve Company IPs" method: GET path: "/v1/companies/ips" tags: ["Companies", "v1"] --- # Retrieve Company IPs `GET /v1/companies/ips` Fetch known IP addresses associated with a given set of companies, enabling identification of web traffic and network activity linked to those organizations based on the provided company IDs. Credit Note: Retrieving IP address data consumes 1 credit per company, unless the company's IP data was already accessed within the last 12 months. :::info Requires the `companies:read` OAuth2 scope. ::: ## Query parameters - `account_id` string, required - `company_ids` string, required - `max_ip_addresses` integer - `include` 'company' ## Response `200` Success - object - `data` CompanyIpV1[], required - `type` 'company_ip', required — The type of the object. - `id` string, required — The Leadfeeder company ID. - `attributes` object, required - `ips` string[], required — A list of IP addresses or IP ranges ordered by confidence score (from very high to low). Single IPs are represented as a plain address (e.g. "192.0.2.1"), ranges as "start-end" (e.g. "192.0.2.1-192.0.2.255"). - `ips_extended` IpAddressExtendedV1[], required — A list of IP addresses or IP ranges in the extended format with additional information such as geo location. The addresses are ordered by confidence score (from very high to low). - `start_ip` string — The start IP address of the range. - `end_ip` string — The end IP address of the range. If it is different from the start IP, it resembels an IP range. - `confidence_score` 'very_high' | 'high' | 'medium' | 'low' — The confidence score of the IP address. - `location` object - `geonames_id` number, nullable — The geonames ID of the location. - `city` string, nullable — The city of the IP address. - `region` string, nullable — The region of the IP address. - `country_code` string, nullable — The country code of the IP address. - `has_other_group_companies_with_ips` boolean, required — Whether there are other companies in the same group that also have IP data available. - `relationships` object, required - `company` union, required — The company the IP data belongs to. By default this field only contains the `id` and `type` fields, but you can load all company attributes by passing the `include=company` URL parameter. - object - `id` string, required — The Leadfeeder company ID. - `type` 'company', required - CompanyV1 - `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. - … - `meta` object, required - `credits` object, required - `charged` number, required — How many credits were consumed for this request. - `request_id` string, required — A unique identifier assigned to each API request for end-to-end traceability. ## Other responses - `400` — Invalid request parameters - `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)