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.
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
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 toas_number
. - February 18, 2021: Published.
Feedback
0 comments
Please sign in to leave a comment.