Sign in

v1

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

Get details of a monitored company.

Get the details of a company identified by its id.

get/api/v2/companies/{id}

Path parameters

idinteger required

The id of the company requested.

Response

Success

CompanyIdinteger required

The ID of the company in BlackKite.

CompanyNamestring

The name of the company in BlackKite.

DomainNamestring

The main domain value of the company.

Type'normal' | 'group'

There are two types of companies; normal and group. Group companies are formed by grouping normal or group companies.

DashboardLinkstring

The BlackKite portal dashboard link for the specified company.

Countrystring nullable

The full country name of the company.

ScanStatus'Extended Scan Queued' | 'Extended Scan Running' | 'Extended Scan Failed' | 'Extended Results Ready' | 'Extended Rescan Queued' | 'Extended Rescan Running' | 'Extended Rescan Failed' | 'Extended Rescan Results Ready' | 'Unknown Scan Status'

The ones with "Extended Scan" prefix mean, this is the first time Black Kite executes a comprehensive scan on the related company. This is the phase where extensive technical issues will be extracted. The ones with "Extended Rescan" prefix mean, this is one of the many continuous scans that Black Kite executes against the target company. In summary, when the status value contains both the words "Extended" and "Ready", that means the results are ready for processing.

Example response

{
  "CompanyId": 22,
  "CompanyName": "Demo Inc.",
  "DomainName": "demoinc.com",
  "Type": "normal",
  "CyberRating": {
    "GradeLetter": "B+",
    "CyberRating": 87,
    "BreachIndex": 0.65,
    "RansomwareIndex": 0.322,
    "CyberRatingLastUpdatedAt": "2021-04-01T10:01:17.641Z",
    "RansomwareIndexLastUpdatedAt": "2021-04-01T10:04:17.641Z",
    "BreachIndexLastUpdatedAt": "2021-04-01T10:05:17.641Z"
  },
  "ThreatActor": {
    "OverallAsiScore": 75,
    "ThreatActorResults": [
      {
        "ThreatActorName": "APT20",
        "AsiScore": 82,
        "Reasoning": "The company has strong technical exposure due to one or more CVEs actively exploited by the threat actor. It aligns with sectors or geographies previously targeted by this actor."
      }
    ]
  },
  "Compliance": {
    "Rating": 78,
    "Confidence": 11,
    "Completeness": 78,
    "LastUpdatedAt": "2021-04-01T10:01:17.641Z"
  },
  "FinancialImpact": {
    "Rating": 40845,
    "RatingMin": 10697,
    "RatingMax": 647362,
    "LossMagnitude": 3098734,
    "LossEventFrequency": 0.0132,
    "LastUpdatedAt": "2021-04-01T10:03:17.641Z"
  },
  "FinancialImpacts": [
    {
      "Rating": 40845,
      "RatingMin": 10697,
      "RatingMax": 647362,
      "LossMagnitude": 3098734,
      "LossEventFrequency": 0.0132,
      "LastUpdatedAt": "2021-04-01T10:03:17.641Z",
      "RiskType": "Data Breach"
    }
  ],
  "DashboardLink": "https://app.blackkitetech.com/ecosystem/12/company/22/dashboard",
  "Ecosystems": [
    {
      "EcosystemId": 173,
      "EcosystemName": "MyCompanies"
    }
  ],
  "Licenses": [
    {
      "LicenseType": "Continuous 60-day",
      "LicenseStatus": "Active"
    }
  ],
  "Industry": {
    "IndustryId": 5412,
    "IndustryName": "Manifacturing"
  },
  "Country": "United States of America",
  "Tags": [
    {
      "TagId": 45,
      "TagName": "Finance",
      "TagType": "Custom Tag"
    }
  ],
  "ScanStatus": "Extended Results Ready"
}