v3

latestOpenAPI 3.1.1mit2026-07-3165481.5 MB
Companies
v1

Retrieve Company 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. :::

get/v1/companies/ips

Query parameters

account_idstring required

The Leadfeeder Account ID. The Account ID can be retrieved using the List Accounts endpoint.

company_idsstring required

A comma-separated list of company IDs. Accepts up to 100 company IDs per request.

max_ip_addressesinteger

Maximum number of IP addresses to return per company. Results are ordered by confidence score (highest first).

include'company'

Specify which additional data should be attached to the result. When company is included, the full company attributes are inlined in the relationships.company field. Otherwise only id and type are returned.

Response

Success

Example response

{
  "data": [
    {
      "type": "company_ip",
      "id": "129011",
      "attributes": {
        "ips": [
          "192.0.2.1",
          "10.0.0.1-10.0.0.255"
        ],
        "ips_extended": [
          {
            "start_ip": "123.123.124.1",
            "end_ip": "123.123.124.3",
            "location": {
              "geonames_id": 4379966,
              "city": "Amsterdam",
              "region": "Jihocesky Kraj",
              "country_code": "CZ"
            }
          }
        ]
      },
      "relationships": {
        "company": {
          "id": "129011"
        }
      }
    }
  ],
  "meta": {
    "credits": {
      "charged": 1
    },
    "request_id": "cf054205-dd8c-4473-8689-07c30fe0789f"
  }
}