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