Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Infrastructure Attribution Reasons

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

⇤ Companies

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 Description 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.

Related articles