Sign in

v1

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

List all the domains defined under the company.

List all the domains defined under this company. Domains are classified as active, dormant and aliases.

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

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.

classification'active' | 'dormant'
Example:active

The classification of the domain; active or dormant. If omitted, both will be returned.

status'active' | 'inactive'
Example:active

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

domainstring
Example:acmeinc.com

The exact value of the domain. No wildcard matching or contains is applied.

start_datestring date-time
Example:2026-01-01T00:00:00.000Z

Filters domains discovered or last updated on or after this date. Must be provided with end_date. The date range must not exceed 15 days.

end_datestring date-time
Example:2026-01-15T23:59:59.000Z

Filters domains discovered or last updated on or before this date. Must be provided with start_date. The date range must not exceed 15 days.

Response

Success

DomainIdinteger

The identifier of the domain record.

Domainstring

The domain value itself.

Relationstring

How this domain relates to the main domain of the company. <br/> * Main Domain: The domain(s) provided by the user to initiate the scan or manually added later on.<br/> * Same Whois Email: The domains whose email addresses on their WHOIS records are the same as the ones for the main domain(s).<br/> * Same Whois Email Domain: The domains whose email addresses on their WHOIS records are any of the main domains.<br/> * Same IP Block: The domains hosted in the IP Blocks owned by the company.<br/> * Same Whois Registrant Name: The registrant name on the WHOIS records is the same as (or very similar to) the registrant name of the main domain’s WHOIS record.<br/> * Redirected Domain: The domains that automatically redirect to one of the main domain(s), indicating they are owned or controlled by the same entity and used to route traffic to the primary domain.

IPAddressesstring

A comma separated list of IP addresses.

NSAddressesstring

A comma separated list of NS addresses.

MXAddressesstring

A comma separated list of MX addresses.

Classification'Active' | 'Dormant'

Black Kite automatically classifies the domains as active and dormant. Active domains and corresponding IP addresses are fully scanned, whereas, the dormant domains and their corresponding IP addresses are used in IP Reputation and CDN Security categories. They are excluded from all the other categories in order to reduce the noise that is false positives. Please take a look at the Help documentation on the portal for the algorithm used by the Black Kite to classify a domain as active or dormant.

Status'Active' | 'Inactive'

When the status of a domain is active, its findings will be used to calculate the risk scores and grades. Otherwise, the findings will be removed from the system and the scores/grades will be updated accordingly.

Cpesstring[]

A list of related CPEs.

Productsstring[]

A list of product names.

DiscoveredDatestring date-time

The date when Black Kite discovered the domain.

LastUpdateDatestring date-time

The date when Black Kite last updated the domain.

Example response

[
  {
    "DomainId": 12345,
    "Domain": "acmeincsupport.com",
    "Relation": "Main Domain",
    "Whois": {
      "Email": "admin@acmeinc.com",
      "Registrar": "MarkMonitor Inc.",
      "Registrant": "Acme, Inc MV",
      "Country": "Canada"
    },
    "IPAddresses": "192.168.1.1, 192.1682.1.2",
    "NSAddresses": "ns1-201-dns.com, ns1-202-dns.com",
    "MXAddresses": "acmeinc.com.mail.protection.com",
    "Classification": "Active",
    "Status": "Active",
    "Cpes": [
      "cpe:/a:product:product:4.89:rc5"
    ],
    "Products": [
      "Wordpress 5.2.11"
    ],
    "DiscoveredDate": "2026-01-01T10:20:30.000Z",
    "LastUpdateDate": "2026-01-03T10:20:30.000Z"
  }
]