GET: Infrastructure Attribution Reasons – Bitsight Knowledge Base

https://api.bitsighttech.com/ratings/v1/companies/company_guid/infrastructure/reasons

View the reason why an IP or CIDR has been attributed to your organization (infrastructure attributions).

Track IP addresses and CIDR blocks attributed to your organization.
Work with registrars to keep registrations up-to-date (if applicable). Such quick turnarounds will ensure that an organization's Bitsight Security Rating will correctly reflect their security posture.

Learn more about:

Parameters

* Required.

Parameter	Values
all_matching_cidrs [Query] Flag to get reasons for all CIDR matches.	[Boolean] `true` = Get the attribution reasons for all matching CIDR blocks.
guid * [Path] Identify the organization to query.	[String] Your organization’s company unique identifier [`company_guid`]. See GET: Portfolio Details.
net_cidr * [Query] Identify the IP or CIDR to query.	[String] An IP address or CIDR block that belongs to your organization.
include_subsidiaries [Query] Include reasons for your subsidiaries.	[Boolean] `true` = Include reasons for your subsidiaries.

Example Request

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/infrastructure/reasons?net_cidr=128.197.192.251 -u api_token:

Example Response

[
  {
    "reasons":[
      {
        "category":"DNS_hostname",
        "is_expired":true,
        "value":"joresources.bu.edu"
      }
    ],
    "source":"DNS",
    "cidr":"128.197.192.251",
    "as_number":null,
    "whois_url":null
  }
]

Response Attributes

Field		Description
reasons Array		Infrastructure attribution details.
	category String	For internal Bitsight use to provide a description of the source for attributing the IP or CIDR to the company.
	is_expired Boolean	`true` = The attribution reason is expired.
	value String	The name of the CIDR network.
source String		The infrastructure data source.
cidr String		The attributed IP or CIDR block.
as_number Array		The autonomous system number.
whois_url String		The URL of the WHOIS record.

December 14, 2022: New is_expired & whois_url fields; virtual_as field changed to as_number.
February 18, 2021: Published.

Parameters

Example Request

Example Response

Response Attributes

Related articles