GET: My Infrastructure

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

GET: My Infrastructure Report is available and is recommended over this endpoint.

Use this endpoint to get information about your infrastructure.

  • Track IP addresses and domains attributed to your organization.
  • Stay informed of existing infrastructure elements and new items that are added to your infrastructure.
  • 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.

Parameters

* Required.

active_only

[Query]

Value: [Boolean]

  • true = Include only active CIDR blocks.
  • false = Include all CIDR blocks.
company_guid

* Required.

[Path] Identify the company to query.

Value: [String] Company unique identifier [entity_guid]. See GET: Portfolio Details.

-o my_infrastructure.csv

[Query] Writes the CSV data to the my_infrastructure.csv file.

Value: [String]

format

* Required.

[Query] Formats the response as a CSV.

Value: [String] csv

type

* Required.

[Query] Filter by asset type.

Value: [String]

  • ip
  • domain

Example Request

Ensure you write the response to a file or prepare another system to receive the data stream.

curl 'https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/reports/infrastructure/?format=csv&type=ip' -u api_token: -o my_infrastructure.csv

Example Response

The response will be CSV data.

CIDR Block,Link,Country,AS Number,Start Date,End Date,Attributed To,IP Count,Tags
192.168.175.182/29,,TH,,2013-02-04,2018-04-20,"Saperix, Inc.",8,Corporate Wi-Fi
192.168.1.184/30,,TH,,2009-06-04,Active,"Saperix, Inc.",4,
192.168.5.50,,,,2011-01-01,Active,"Saperix, Inc.",1,
192.168.97.245,,,,2011-01-01,Active,"Saperix, Inc.",1,
192.168.66.168,,,,2011-01-01,Active,"Saperix, Inc.",1,Boston User Network
192.168.200.53,,,,2011-01-01,Active,"Saperix, Inc.",1,
192.168.127.231,,,,2011-01-01,Active,"Saperix, Inc.",1,
192.168.115.75,,,,2011-01-01,Active,"Saperix, Inc.",1,
,,,,,,,,
Disclaimer: This document contains sensitive information intended only for authorized viewers. Use of this data must adhere to the Bitsight Terms and Conditions.,,,,,,,,
  • May 17, 2023: GET: My Infrastructure Report [/v1/companies/{company_guid}/infrastructure] now available.
  • March 15, 2020: Added active_only, company_guid, & tags parameters.
  • May 18, 2018: Published.
Was this article helpful?
5 out of 5 found this helpful

Comments

0 comments

Please sign in to leave a comment.