---
title: "List all the IP addresses that belong to the company."
method: GET
path: "/api/v2/companies/{id}/ips"
tags: ["Company Digital Footprint"]
---

# List all the IP addresses that belong to the company.

`GET /api/v2/companies/{id}/ips`

List all the IPs that are located under this company. Not all IPs defined under a company is included in the Black Kite scans. For example an IP with status Inactive is not included in the scan.

## Path parameters

- `id` integer, required

## Query parameters

- `page_number` integer
- `page_size` 10 | 20 | 30 | 50 | 100 | 250
- `status` 'active' | 'inactive'
- `query` string
- `start_date` string, date-time
- `end_date` string, date-time

## Response `200`

Success

- IPAddress[]
  - `IPAddress` string — The IP Address.
  - `SourceAsset` string[], nullable — The domain or subdomain associated with the IP address (if any). The IP address can also be related to the company through an SSL certificate on it. That is shown by using a source asset structure such as; SSL_CERT_f369e5037f9c52299757395f6f3a51f37601bb459f1660ec767c8cb3fb6ffbcf.imap.example.com which means that on an SSL certificate whose SHA256 value is f369e5037f9c52299757395f6f3a51f37601bb459f1660ec767c8cb3fb6ffbcf mentions the subdomain imap.example.com that belongs to the example.com
  - `Description` string, nullable — The IP block description. Parsed from other sources, so output validation might be a good idea when rendering.
  - `Name` string, nullable — The NetName value of the IP block that this IP address belongs to.
  - `NetCIDR` string — The CIDR value of the IP block that this IP address belongs to.
  - `Status` 'Active' | 'Inactive' — Whether the IP address is active (included) or inactive (excluded) in the security scans' scope. When the IP address is active, then it is included in the scans. Excluded otherwise. Excluded IP addresses won't be scanned, therefore, won't affect the risk scores.
  - `EmailAddresses` string[], nullable — The email address(es) that the IP address registered with.
  - `OpenPorts` number[], nullable — The open port values on the IP address.
  - `IsManuallyAdded` boolean — True if added manually through the API or manually through the portal.
  - `DiscoveredDate` string, date-time — The date when Black Kite discovered the IP address.
  - `LastUpdateDate` string, date-time — The date when Black Kite last updated the IP address.

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `404` — Not Found
- `default` — Failure

---

[API](https://skmtc.net/blackkitetech/apis/black-kite-api.md) · [All operations](https://skmtc.net/blackkitetech/apis/black-kite-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/blackkitetech/black-kite-api/revisions/7dadaba760fb/schema)