Infrastructure Attribution API Guide – Bitsight Knowledge Base

Use these API endpoints to manage your network infrastructure.

Path	Purpose	Description
/v1/companies/company_guid/assets	GET: Assets	Get a company’s asset information (domains and IP addresses), including asset importance and the number of findings.
/v1/companies/company_guid/company-tree	GET: Ratings Tree	Get the company details of an organization’s parent company, followed by all of its subsidiaries.
/v1/companies/company_guid/countries	GET: IP Addresses by Country	Get the number of IP addresses in an organization's IP address space, by country.
/v1/companies/company_guid/infrastructure/changes	GET: Infrastructure Changes	See changes in your organization’s infrastructure (infrastructure changes) and details about the change.
/v1/companies/company_guid/infrastructure/reasons	GET: Infrastructure Attribution Reasons	View the reason why an IP or CIDR has been attributed to your organization (infrastructure attributions).
/v1/companies/infrastructure/requests/	GET: Company-Provided Assets	See your Company-Provided Assets.
/v1/companies/company_guid/reports/infrastructure	GET: My Infrastructure Report	Get or download a CSV of your infrastructure information.
/v1/companies/infrastructure/bulk	POST: Add Assets in Bulk	Set an end date for infrastructure or add assets to your infrastructure. The source of added assets are considered to be "company"-provided.”
/v1/companies/infrastructure/expiration	POST: Set an End Date for Company-Provided Assets	Set an end date for a company-provided asset.

July 10, 2023: Removed PDF.
May 17, 2023: Replaced GET: My Infrastructure [/v1/companies/{company_guid}/reports/infrastructure] with GET: My Infrastructure Report [/v1/companies/{company_guid}/infrastructure].
March 31, 2023: POST: Add Assets in Bulk [/v1/companies/infrastructure/bulk] & GET: Company-Provided Assets [/v1/companies/infrastructure/requests/].

Related articles