Companies API Endpoint

Ingrid

Get information about a company (including companies your organization and companies in your portfolio) and manage company information. The information includes:

4th Party
Company Data
Cyber Insurance
Findings and Observations
Infrastructure
Infrastructure Tags
Issue Tracking
Peer Analytics
Portfolio
Statistics

Each /companies/company_guid path provides information about a single company. To access information about all companies in your portfolio, refer to the Portfolio or CNI Portfolio API endpoints.

See all other endpoints.

4th Party

GET: Products in a Ratings Tree

Get service provider products that are used by companies in a ratings tree.

Method: GET

Path: /v1/companies/company_guid/company-tree/products

GET: Product Usage of Companies in a Ratings Tree

List the third parties in a Ratings Tree that use a particular service provider product.

Method: GET

Path: /v1/companies/company_guid/company-tree/products/product_guid/companies

GET: Product Types in a Ratings Tree

List the product types used by all companies in the Ratings Tree of a third party.

Method: GET

Path: /v1/companies/company_guid/company-tree/product-types

GET: Service Providers of a Third Party

Get all service providers for the entire ratings tree of one of the companies you’re monitoring.

Method: GET

Path: /v1/companies/company_guid/company-tree/providers

GET: Dependency on a Specific Service Provider in a Ratings Tree

Get the companies in a ratings tree that depend on a specific service provider.

Method: GET

Path: /v1/companies/company_guid/company-tree/providers/provider_guid/companies

GET: Products of a Specific Service Provider in a Ratings Tree

Get the products provided to companies within a ratings tree by a specific service provider.

Method: GET

Path: /v1/companies/company_guid/company-tree/providers/provider_guid/products

GET: Enterprise Products Used by a Single Domain

Get the enterprise products that are used by a particular company from a single domain.

Method: GET

Path: /v1/companies/company_guid/domains/DOMAIN.TLD/products

GET: Service Providers for a Specific Domain

Get the service providers of the products used in a specific domain.

Method: GET

Path: /v1/companies/company_guid/domains/domain_name/providers

GET: Products of a Company

Get the enterprise products used at the domains of a particular company.

Method: GET

Path: /v1/companies/company_guid/products

POST: Products of a Company

Get the enterprise products used at the domains of a particular company.

Method: POST

Path: /v1/companies/company_guid/products

GET: Domains of a Company Using a Specific Product

List the domains that belong to a company using a specific service provider product.

Method: GET

Path: /v1/companies/company_guid/products/product_guid/domains

GET: Service Providers of a Specific Company

Get the service providers that a specific company depends on.

Method: GET

Path: /v1/companies/company_guid/providers

GET: Shared Service Provider Domains

Get the domains that are shared by a company and their service provider.

Method: GET

Path: /v1/companies/company_guid/providers/provider_guid/domains

Company Data

GET: Company Details

Get a company’s details, including: Their rating, rating history, risk vector grades, company info and relationship.

Method: GET

Path: /v1/companies/company_guid

GET: Country Details

Get 1 year of Bitsight data of subscribed countries.

Method: GET

Path: /v1/companies/country_guid

GET: Assets

Get a company’s asset information (domains and IP addresses), including asset importance and the number of findings.

Method: GET

Path: /v1/companies/company_guid/assets

GET: Asset Risk Matrix

Get the counts and the severity of security findings for a given company.

Method: GET

Path: /v1/companies/company_guid/assets/statistics

GET: Ratings Tree

Retrieve a company’s information, followed by all of its subsidiaries. Since subsidiaries may also possess its own subsidiary that are related to the parent company as part of the bundle, this path continues past the first generation when returning subsidiary data.

Method: GET

Path: /v1/companies/company_guid/company-tree

GET: IP Address by Country

Get the number of IP addresses for an organization’s IP address space by country.

Method: GET

Path: /v1/companies/company_guid/countries

GET: Download NIST CSF Report

Get a high-level summary of an organization‘s alignment with the US National Institute of Standards and Technology’s cybersecurity Framework (NIST CSF) using Bitsight risk vectors and existing data as evidence.

Method: GET

Path: /v1/companies/company_guid/regulatory/nist

GET: Preview Report with Industry Comparison

Get a synopsis of how a company is performing compared to its industry peers.

Method: GET

Path: /v1/companies/company_guid/reports/company-preview

GET: Ratings History

Get a CSV file containing a history of a particular company’s security ratings over the past year.

Method: GET

Path: /v1/companies/company_guid/reports/ratings-history?format=csv

GET: Risk Vectors Summary

Get a summary of a company’s risk vector performance. A CSV will be downloaded to your desktop.

Method: GET

Path: /v1/companies/company_guid/risk-vectors/summaries

GET: Company Requests Summary

Get a summary of your organization’s company requests.

Method: GET

Path: /v1/companies/infrastructure/requests/summaries

Cyber Insurance

GET: Compare Client to the Underwriting Guidelines

Compare a client’s risk vectors and their grades to your underwriting guidelines.

Method: GET

Path: /v1/companies/client_guid/underwriting-guidelines

Portfolio

PATCH: Highlight Primary or Assign Custom ID

Highlight a primary for your organization or assign a custom ID for a portfolio company.

Method: PATCH

Path: /v1/companies/company_guid

GET: Tiering Recommendation

Get tiering recommendations.

Method: GET

Path: /v1/companies/company_guid/tier/recommendation

GET: Rating Distribution by Rating Category

Get the rating distribution for all companies in the Bitsight inventory by rating category. This helps compare your own portfolio composition against the Bitsight ecosystem.

Method: GET

Path: /v1/companies/distribution

GET: Company Search

Search for a company in the Bitsight inventory by name or domain.

Method: GET

Path: /v1/companies/search?query_parameter

GET: Trending Companies

See 20 companies that have been actively searched and viewed by other Bitsight users during the past week, as presented in the Trending Vendors card in the Portfolio Dashboard.

Method: GET

Path: /v1/companies/search/trending

Statistics

GET: Diligence Finding Counts of a Company

Get the number of Diligence findings of a company.

Method: GET

Path: /v1/companies/company_guid/diligence/historical-statistics

GET: Diligence Statistics

Get Diligence statistics of a company.

Method: GET

Path: /v1/companies/company_guid/diligence/statistics

GET: Industry Statistics

Get industry statistics for a company.

Method: GET

Path: /v1/companies/company_guid/industries/statistics

GET: Statistics

Get Compromised Systems statistics of a company during the past 1 year. The data includes the number of findings by risk vector and the average event duration in days.

Method: GET

Path: /v1/companies/company_guid/observations/statistics?fields=risk_types

GET: User Behavior Statistics

Get User Behavior statistics of a company.

Method: GET

Path: /v1/companies/company_guid/user-behavior/statistics

Findings and Observations

GET: Finding Details

Get an organization’s finding (events and records) details.

Method: GET

Path: /v1/companies/company_guid/findings

GET: Findings Statistics

Get findings statistics of a company.

Method: GET

Path: /v1/companies/company_guid/findings/statistics

GET: Findings Summaries

Summarized findings data for a company in your ratings tree.

Method: GET

Path: /v1/companies/company_guid/findings/summaries

GET: Findings Summary of a Company

See the presence of infection, server software, or vulnerability findings in a company.

Method: GET

Path: /v1/companies/company_guid/findings/summary

GET: Detailed Company Observations

View detailed observations for a company.

Method: GET

Path: /v1/companies/company_guid/observations

Infrastructure

GET: Asset Summaries

Summarized asset data for a company in your ratings tree.

Method: GET

Path: /v1/companies/company_guid/assets/summaries

GET: My Infrastructure Report

Get or download a CSV of your infrastructure information.

Method: GET

Path: /v1/companies/company_guid/infrastructure

GET: Infrastructure Changes

See changes in your organization’s infrastructure and details about the change.

Method: GET

Path: /v1/companies/company_guid/infrastructure/changes

POST: Delete Custom Infrastructure in Bulk

Delete one or more assets from a company's custom infrastructure and no longer be attributed to them.

Method: POST

Path: /v1/companies/company_guid/infrastructure/custom/bulk/

GET: Infrastructure Attribution Reasons

Get the reason why an IP or CIDR has been attributed to your organization.

Method: GET

Path: /v1/companies/company_guid/infrastructure/reasons

GET: My Infrastructure

Identify IP addresses and domains attributed to your organization in an automated way, stay informed of existing infrastructure elements and new items that are added to the list, and also work with registrars (if applicable) to keep registrations up-to-date.

Recommended: GET: My Infrastructure Report is available and is recommended over this endpoint.

Method: GET

Path: /v1/companies/company_guid/reports/infrastructure

GET: Company-Provided Assets