Companies
v1

Retrieve Company IPs

Changed on

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

Request

  • Base URL
    https://api.leadfeeder.com
  • URL
    https://api.leadfeeder.com/v1/companies/ips
  • Auth
    • API key in header X-Api-Key
    • or OAuth 2
      Authorization code: https://api.leadfeeder.com/v1/oauth/authorize
      Token URL: https://api.leadfeeder.com/v1/oauth/token scopes: companies:read

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 entries (single IPs or ranges) returned per company. A range counts as one entry regardless of how many addresses it covers. Ordered by confidence score, highest first. Each returned company reports its full entry count in meta.total_count. Capped at 500; values above the maximum are clamped to 500.

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

Changes

    • info

      added the optional property //////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property ////////////////////////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property ////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      added the optional property //////////////////////// to the response with the status

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_connections/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_group_connections/items/relationships/crm_connection/oneOf[CRMConnectionV1]/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMContactV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMLeadV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/attributes/zip_code deprecated

    • info

      response property data/items/relationships/company/oneOf[CompanyV1]/relationships/crm_suggestions/items/relationships/crm_record/oneOf[CRMOrganizationV1]/relationships/crm_owner/oneOf[CRMUserV1]/attributes/first_name deprecated

    • breaking

      the response property //////////// became nullable for the status

    • breaking

      the response property //////////// became nullable for the status

    • breaking

      the response property //////////// became nullable for the status