---
title: "List all the domains defined under the company."
method: GET
path: "/api/v2/companies/{id}/domains"
tags: ["Company Digital Footprint"]
---

# List all the domains defined under the company.

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

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

## Path parameters

- `id` integer, required

## Query parameters

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

## Response `200`

Success

- Domain[]
  - `DomainId` integer — The identifier of the domain record.
  - `Domain` string — The domain value itself.
  - `Relation` string — 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.
  - `Whois` Whois — The registrar, registrant, create date, expire date, registrant country, and registrant e-mail information of the related domain.
    - `Email` string — The email address of the registrant. Parsed from other sources, so output validation might be a good idea when rendering.
    - `Registrar` string — The registrar providing the registration services fro the registrants. Parsed from other sources, so output validation might be a good idea when rendering.
    - `Registrant` string — The registrant is considered the owner of the domain. Parsed from other sources, so output validation might be a good idea when rendering.
    - `CreateDate` string, date-time, nullable — The date the related domain is registered. The format of the this date-time field may differ. A valid example is, 1991-05-02T04:00:00.000Z. Another valid example is 04/24/2020 08:44:02.
    - `ExpireDate` string, date-time, nullable — The date the related domain's registration will expire. The format of the this date-time field may differ. A valid example is, 1991-05-02T04:00:00.000Z. Another valid example is 04/24/2020 08:44:02.
    - `Country` string — The country of the registrant.
  - `IPAddresses` string — A comma separated list of IP addresses.
  - `NSAddresses` string — A comma separated list of NS addresses.
  - `MXAddresses` string — 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.
  - `Cpes` string[] — A list of related CPEs.
  - `Products` string[] — A list of product names.
  - `DiscoveredDate` string, date-time — The date when Black Kite discovered the domain.
  - `LastUpdateDate` string, date-time — The date when Black Kite last updated the domain.

## 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)