GET: Infrastructure Attribution Reasons

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:

• How attributions are affected if a company’s infrastructure is modified
• Infrastructure Management

Parameters

* Required.

all_matching_cidrs

[Query] Flag to get reasons for all CIDR matches.

Value: [Boolean] true = Get the attribution reasons for all matching CIDR blocks.

guid

* Required.

[Path] Identify the organization to query.

Value: [String] Your organization’s company unique identifier [company_guid]. See GET: Portfolio Details.

net_cidr

* Required.

[Query] Identify the IP or CIDR to query.

Value: [String] An IP address or CIDR block that belongs to your organization.

include_subsidiaries

[Query] Include reasons for your subsidiaries.

Value: [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

reasons

category

is_expired

value

source

cidr

as_number

whois_url