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

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

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

List all the IP blocks that are located under this company. Not all IP blocks defined under a company is included in the Black Kite scans. For example an IP block 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

## Response `200`

Success

- IPBlock[]
  - `NetCIDR` string — The net CIDR value. The IP block in Network CIDR notation.
  - `Name` string, nullable — The IP block NetName.
  - `Description` string, nullable — The IP block description. Parsed from other sources, so output validation might be a good idea when rendering.
  - `CountryCode` string — The short code of the individual country.
  - `Handle` string, nullable — The Nic handle value. Parsed from other sources, so output validation might be a good idea when rendering.
  - `Status` 'Active' | 'Inactive' — Whether the IP block is active (included) or inactive (excluded) in the security scans' scope. When the IP Block is active, then it is included in the scans. Excluded otherwise. Excluded IP blocks won't be scanned, therefore, won't affect the risk scores.
  - `Detail` string — The detailed IP block information. Parsed from other sources, so output validation might be a good idea when rendering.
  - `IsManuallyAdded` boolean — True if added manually through the API or manually through the portal.

## 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/versions/7dadaba760fb/schema)