Sign in

v1

latestOpenAPI 3.0.0Proprietary - Commercial Use Only2026-08-06172139621.6 KB
Company Digital Footprint

List all the IP blocks that belong to the company.

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.

get/api/v2/companies/{id}/ipblocks

Path parameters

idinteger required

The id of the target company.

Query parameters

page_numberinteger
Example:1

The number of the page requested.

page_size10 | 20 | 30 | 50 | 100 | 250
Example:10

The number of result items in a single response.

status'active' | 'inactive'
Example:active

The status of the IP block; active or inactive. If omitted, both will be returned.

querystring
Example:Acme

The value will be searched in the CIDR, Name, Country, Handle and Description response fields.

Response

Success

NetCIDRstring

The net CIDR value. The IP block in Network CIDR notation.

Namestring nullable

The IP block NetName.

Descriptionstring nullable

The IP block description. Parsed from other sources, so output validation might be a good idea when rendering.

CountryCodestring

The short code of the individual country.

Handlestring 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.

Detailstring

The detailed IP block information. Parsed from other sources, so output validation might be a good idea when rendering.

IsManuallyAddedboolean

True if added manually through the API or manually through the portal.

Example response

[
  {
    "NetCIDR": "192.168.77.172/30 ",
    "Name": "ACME-NET-TTR",
    "Description": "Acme Inc.",
    "CountryCode": "US",
    "Handle": "ACME32-RIPE",
    "Status": "Active",
    "Detail": "#\n# ARIN WHOIS data and services are subject to the Terms of Use \n# available..."
  }
]