--- title: "Get a risk score summary of a monitored company." method: GET path: "/api/v2/companies/{id}/summary" tags: ["Company"] --- # Get a risk score summary of a monitored company. `GET /api/v2/companies/{id}/summary` Get the consolidated risk score of a company identified by its id. ## Path parameters - `id` integer, required ## Response `200` Success - CompanyRiskSummary - `DomainName` string, required — The main domain value of the company. - `TechnicalSummary` TechnicalSummary - `GradeLetter` 'A+' | 'A' | 'A-' | 'B+' | 'B' | 'B-' | 'C+' | 'C' | 'C-' | 'D+' | 'D' | 'D-' | 'F' — Overall technical risk score translated into GPA letter grades. - `CyberRating` number — Overall technical risk score. - `CyberRatingAsString` 'Excellent' | 'Good' | 'Average' | 'Poor' | 'Bad' — A string converted technical risk score. - `CompletedAt` string, date-time — The last time a full security scan is executed. - `LastUpdatedAt` string, date-time — The recent date the company risk score is calculated. The risk score calculation is triggered due to a new scan or manual changes. A new scan can be triggered by the system due to Black Kite scans' continuous nature or it can be triggered manually through the Black Kite portal interface, such as Rescan Company, Rescan Category etc. Manual changes are usually done through the Black Kite portal. It may be one of; changing the status of a finding, hitting the Recalculate Category Grade button, excluding IP address/domains from the digital footpring etc. In general this value is more recent or equal to the CompletedAt value. - `SafeGuard` object — Individual SafeGuard categories; Patch Management, Application Security, CDN Security and Web Site Security. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — An over-all grade which is calculated based on categories Patch Management, Application Security, CDN Security and Web Site Security. - `PatchManagement` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `ApplicationSecurity` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `CDNSecurity` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `WebsiteSecurity` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `Reputation` object — Individual Reputation categories; Brand Monitoring, IP Reputation, Fraudulent Apps, Fraudulent Domains and Web Ranking. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — An over-all grade which is calculated based on categories Brand Monitoring, IP Reputation, Fraudulent Apps, Fraudulent Domains and Web Ranking. - `BrandMonitoring` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `IPReputation` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `FraudulentApps` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `FraudulentDomains` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `WebRanking` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `Resiliency` object — Individual Resiliency categories; Attack Surface, DNS Health, Email Security, DDOS Resiliency and Network Security. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — An over-all grade which is calculated based on categories Attack Surface, DNS Health, Email Security, DDOS Resiliency and Network Security. - `AttackSurface` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `DNSHealth` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `EmailSecurity` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `DDoSResiliency` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `NetworkSecurity` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `Privacy` object — Individual Privacy categories; SSL Strength, Credential Management, Hacktivist Shares and Information Disclosure. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — An over-all grade which is calculated based on categories SSL Strength, Credential Management, Hacktivist Shares and Information Disclosure. - `SSLStrength` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `CredentialManagement` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `HacktivistShares` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `SocialNetwork` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `InformationDisclosure` TechnicalCategorySummary - `Description` string — The string description of individual category. - `CyberRating` number — Technical numerical risk rating score of this individual category. - `GradeLetter` 'A' | 'B' | 'C' | 'D' | 'F' — A letter grade of this indivudual category. - `LastUpdatedAt` string, date-time — The recent date the risk score of this individual category is calculated. This calculation is triggered either automatically or manually. In general this value is less recent or equal to the LastUpdatedAt value of the top level risk score of this company. - `ComplianceSummary` object[] - `Standard` string — The code for specific compliance standard. You can see the list of standards using the "api/v2/compliance/standards" endpoint. - `Rating` number — The overall compliance score value. - `Completeness` number — The amount of the framework has been analyzed. - `Confidence` number — The level of confidence of the corresponding estimation. - `LastUpdatedAt` string, date-time — The recent date that the compliance score is calculated. - `FinancialSummary` FinancialSummary - `Avg` number, float — The average amount of forecasted annualized loss. - `Min` number, float — The minimum amount of forecasted annualized loss. - `Max` number, float — The maximum amount of forecasted annualized loss. - `LossEventFrequency` object - `Value` number, float — Probable frequency, over a year, that a threat agent will succeed and their action will result in a loss to the company. - `ThreatEventFrequency` object - `Value` number — How many times will the organization face a threat action. - `ContactFrequency` object - `Value` number — How many times over the next year is the threat actor/agent likely to reach the organization. - `ProbabilityOfAction` object - `Value` number, float — What percentage of threat agent/actor contacts with the asset are likely to result in threat events. - `Vulnerability` object - `Value` number, float — What percentage of threat events are likely to result in loss events. - `ThreatCapability` object - `Value` number, float — How many times over the next year is the threat actor/agent likely to reach the organization. - `ResistanceStrength` object - `Value` number, float — The strength of a control as compared to a baseline unit of force. - `LossMagnitude` object - `Value` number, float — How much loss is our organization likely to experience as a direct result of a loss event. - `PrimaryLoss` object - `Value` number, float — How much money are we likely to lose from each loss event. - `Exposure` object - `AvgNumberOfRecords` number, float — The average number of records shared. - `AvgNumberOfOtherRecords` number, float — The average number of OTHER records shared. - `CostPerRecord` number, float — The average cost per record. - `CostPerOtherRecord` number, float — The average cost per OTHER record. - `TimeToIdentifyAndContain` number — Time to identify the breach in hours. - `HasInternalNetworkAccess` boolean — Whether the organization with which the data is shared has an internal access to your organization. - `SecondaryLoss` object - `Value` number, float — How much loss as a result of secondary stakeholders. - `DetectionAndEscalation` number, float — Cost to detect and escalate. - `Notification` number, float — Cost to notify. - `PostDataBreachResponse` number, float — Cost to post breach operations. - `LostBusiness` number, float — Cost of lost business. - `FinancialSummaries` union[] — An array of Financial Summary of this company. It contains all models of Financial Risk (FAIR). - union - FinancialDataBreachSummary - `RiskType` string — The type of Financial Risk. It can be Data Breach, Ransomware or Business Interruption - `Avg` number, float — The average amount of forecasted annualized loss. - `Min` number, float — The minimum amount of forecasted annualized loss. - `Max` number, float — The maximum amount of forecasted annualized loss. - `LossEventFrequency` object - `Value` number, float — Probable frequency, over a year, that a threat agent will succeed and their action will result in a loss to the company. - `ThreatEventFrequency` object - `Value` number — How many times will the organization face a threat action. - `ContactFrequency` object - … - `ProbabilityOfAction` object - … - `Vulnerability` object - `Value` number, float — What percentage of threat events are likely to result in loss events. - `ThreatCapability` object - … - `ResistanceStrength` object - … - `LossMagnitude` object - `Value` number, float — How much loss is our organization likely to experience as a direct result of a loss event. - `PrimaryLoss` object - `Value` number, float — How much money are we likely to lose from each loss event. - `Exposure` object - … - `SecondaryLoss` object - `Value` number, float — How much loss as a result of secondary stakeholders. - `DetectionAndEscalation` number, float — Cost to detect and escalate. - `Notification` number, float — Cost to notify. - `PostDataBreachResponse` number, float — Cost to post breach operations. - `LostBusiness` number, float — Cost of lost business. - FinancialRansomwareSummary - `RiskType` string — The type of Financial Risk. It can be Data Breach, Ransomware or Business Interruption - `Avg` number, float — The average amount of forecasted annualized loss. - `Min` number, float — The minimum amount of forecasted annualized loss. - `Max` number, float — The maximum amount of forecasted annualized loss. - `LossEventFrequency` object - `Value` number, float — Probable frequency, over a year, that a threat agent will succeed and their action will result in a loss to the company. - `ThreatEventFrequency` object - `Value` number — How many times will the organization face a threat action. - `Vulnerability` object - `Value` number, float — What percentage of threat events are likely to result in loss events. - `LossMagnitude` object - `Value` number, float — How much loss is our organization likely to experience as a direct result of a loss event. - `PrimaryLoss` object - `Value` number, float — How much money are we likely to lose from each loss event. - `EstimatedRansom` number, float — Represents the estimated payment that the organization would need to make to the attacker in order to regain access to their data and systems. - `InsuranceDeductible` number, float — Refers to the amount that the organization would need to pay out of pocket before their insurance coverage kicks in. - `CostOfDowntime` number, float — Represents the estimated financial impact of the downtime caused by the ransomware attack, such as lost revenue, increased expenses, and legal fees. - `Exposure` object - … - `SecondaryLoss` object - `Value` number, float — How much loss as a result of secondary stakeholders. - `RegulatoryFine` number, float — Refers to the cost of any fines or penalties imposed by regulators as a result of the ransomware attack. - `EstimatedInsuranceImpactfication` number, float — Refers to the estimated financial impact on the organization's insurance coverage, such as the deductible or policy limits. - `LossOfBusiness` number, float — Represents the estimated financial impact of the reputational damage caused by the ransomware attack, such as loss of customers or market share. - FinancialBusinessInterruptionSummary - `RiskType` string — The type of Financial Risk. It can be Data Breach, Ransomware or Business Interruption - `Avg` number, float — The average amount of forecasted annualized loss. - `Min` number, float — The minimum amount of forecasted annualized loss. - `Max` number, float — The maximum amount of forecasted annualized loss. - `LossEventFrequency` object - `Value` number, float — Probable frequency, over a year, that a threat agent will succeed and their action will result in a loss to the company. - `ThreatEventFrequency` object - `Value` number — How many times will the organization face a threat action. - `Vulnerability` object - `Value` number, float — What percentage of threat events are likely to result in loss events. - `LossMagnitude` object - `Value` number, float — How much loss is our organization likely to experience as a direct result of a loss event. - `PrimaryLoss` object - `Value` number, float — How much money are we likely to lose from each loss event. - `RecoveryCosts` number, float — Refer to the costs associated with restoring the organization's systems and operations after the interruption event. - `InsuranceDeductible` number, float — Refers to the amount that the organization would need to pay out of pocket before their insurance coverage kicks in. - `CostOfDowntime` number, float — Represents the estimated financial impact of the downtime caused by the ransomware attack, such as lost revenue, increased expenses, and legal fees. - `Exposure` object - … - `SecondaryLoss` object - `Value` number, float — How much loss as a result of secondary stakeholders. - `PenaltyPinch` number, float — A critical measure in FAIR analysis quantifying the secondary financial impacts, typically in terms of time and cost, resulting from penalties incurred during a business interruption event. - `EstimatedInsuranceImpactfication` number, float — Refers to the estimated financial impact on the organization's insurance coverage, such as the deductible or policy limits. - `LossOfBusiness` number, float — Represents the estimated financial impact of the reputational damage caused by the ransomware attack, such as loss of customers or market share. ## 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)