GET: My Infrastructure Report Ingrid https://api.bitsighttech.com/ratings/v1/companies/company_guid/infrastructure Get or download a CSV of your infrastructure information. 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. Sections: Parameters CSV Format Example Request Example Response JSON Format Example Request Example Response Response Attributes Parameters * Required. asn [Query] Filter by autonomous system numbers (ASN) assigned to the company. Applicable to IP addresses/CIDR only. Value: [String] Comma-separated ASN. attributed_to.guid [Query] Filter by the entity attributed to the infrastructure. Value: [String] Comma-separated company unique identifiers [entity_guid]. See GET: Portfolio Details. company_guid * Required. [Path] Identify the company to query. Value: [String] Company unique identifier [entity_guid]. See GET: Portfolio Details. country.code [Query] Filter by the country stated in the registration. Value: [String Comma-separated 2-letter country codes. [Date] start_date [Query] Filter by when this infrastructure was attributed to the company. Value: [String] YYYY-MM-DD [Date] start_date_lt [Query] Before this infrastructure was attributed to the company. Value: [String] YYYY-MM-DD [Date] start_date_lte [Query] When and before this infrastructure was attributed to the company. Value: [String] YYYY-MM-DD [Date] start_date_gt [Query] After this infrastructure was attributed to the company. Value: [String] YYYY-MM-DD [Date] start_date_gte [Query] When and after this infrastructure was attributed to the company. Value: [String] YYYY-MM-DD [Date] end_date [Query] When this infrastructure was no longer attributed. Value: [String] YYYY-MM-DD [Date] end_date_lt [Query] Before this infrastructure was no longer attributed. Value: [String] YYYY-MM-DD [Date] end_date_lte [Query] When and before this infrastructure was no longer attributed. Value: [String] YYYY-MM-DD [Date] end_date_gt [Query] After this infrastructure was no longer attributed. Value: [String] YYYY-MM-DD [Date] end_date_gte [Query] When and after this infrastructure was no longer attributed. Value: [String] YYYY-MM-DD format [Query] Set the format for the response data. Value: [String] CSV ↻ JSON [IP Count] ip_count [Query] Filter by the number of IP addresses. Value: [Integer] IP address count. ip_count_lt [Query] Filter by less than a set number of IP addresses. Value: [Integer] IP address count. ip_count_lte [Query] Filter by a set number or less number of IP addresses. Value: [Integer] IP address count. ip_count_gt [Query] Filter by more than a set number of IP addresses. Value: [Integer] IP address count. ip_count_gte [Query] Filter by a set number or more number of IP addresses. Value: [Integer] IP address count. is_active [Query] Filter by records that are still attributed or were previously attributed to the organization. Value: [Boolean] true = Include only active records, i.e. records without an end date. false = Include all records regardless of the attribution end date. limit [Query] Set the maximum number of results. Value: [Integer] If not provided and format=json, limit defaults to 100. If not provided and format=csv, limit defaults to null. q [Query] Perform a full-text search for matches on all searchable fields. Value: [String] ASN attributed_to Country name source value source [Query] Filter by the source used to associate the infrastructure to the company. Value: [String] Comma-separated source name. See infrastructure data sources. tag_contains [Query] Filter by infrastructure tags. Value: [String] Comma-separated tag names. type [Query] Filter by asset type. Value: [String] Comma-separated: IP (includes both IPv4 and IPv6) IPV4_CIDR IPV6_CIDR Domain value [Query] Filter by IP address, CIDR block, or domain name. Value: [String] Comma-separated: IP name CIDR name Domain name CSV Format Example Request curl 'https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/infrastructure?format=csv&type=ip' -u api_token -o output_file Example Response Value,Type,Source,Tags,Country,Start Date,End Date,Is Active,Attributed To,CIDR Size,Link,AS Number,Reasons,Notes 192.199.225.10,IP,Customer-Provided,Data Center 1,,2011-01-01,2020-09-14,False,Saperix WFH-RO,1,,,, 192.199.225.10,IP,Customer-Provided,Data Center 1,,2022-06-17,Active,True,Awesome Inc,1,,,, 128.197.192.143,IP,Customer-Provided,,,2011-01-01,Active,True,"Saperix, Inc.",1,,,, 192.12.185.111,IP,Customer-Provided,,,2011-01-01,Active,True,"Saperix, Inc.",1,,,, 192.12.185.143,IP,Customer-Provided,,,2011-01-01,Active,True,"Saperix, Inc.",1,,,, 192.12.185.147,IP,Customer-Provided,,,2011-01-01,Active,True,"Saperix, Inc.",1,,,, 192.12.189.15,IP,Customer-Provided,,,2011-01-01,Active,True,"Saperix, Inc.",1,,,, 192.75.80.84,IP,Customer-Provided,,,2011-01-01,Active,True,"Saperix, Inc.",1,,,, 128.197.192.251,IP,DNS,"Primary Website,Security Lab",,2022-10-05,Active,True,"Saperix, Inc.",1,,,DNS hostname: joresources.bu.edu, ,,,,,,,,,,,,, Disclaimer: This document contains sensitive information intended only for authorized viewers. Use of this data must adhere to the Bitsight Terms and Conditions.,,,,,,,,,,,,, JSON Format Example Request curl 'https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/infrastructure?type=domain&limit=2' -u api_token -o output_file Example Response { "links": { "next": "https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/infrastructure?limit=2&offset=2&type=domain", "previous": null }, "count": 99, "results": [ […] { "temporary_id": "X2bR5bTaXZ4d9dccf32a5bcc52b2b13361158f24c2", "value": "saperix.com", "type": "DOMAIN", "source": null, "country": null, "start_date": "2011-01-01", "end_date": null, "is_active": true, "attributed_to": { "guid": "9f16aca1-44ef-4fff-a413-f22ce2894bc7", "name": "Saperix Corporate - US East" }, "ip_count": null, "is_suppressed": false, "tags": [ { "guid": "087a81d2-e0bd-4189-80f2-7b5cad2560b5", "id": 88170, "name": "Primary Website", "is_public": true } ], "asn": null } ] } Response Attributes Field Description links Object Navigation for multiple pages of results. See pagination. next String The URL for navigating to the next page of results. previous String The URL for navigating to the previous page of results. count Integer The number of assets. results Array Assets and their infrastructure details. Object An asset and its infrastructure details. temporary_id String A temporary identifier for this asset. value String The name of this asset. type String The type of asset. source String The source used to associate the infrastructure to the company. country String The country stated in the registration. start_date String [YYYY-MM-DD] When this infrastructure was attributed to the company. end_date String [YYYY-MM-DD] When this infrastructure was no longer attributed. is_active Boolean Indicates if the infrastructure is still attributed or was previously attributed to the organization. true = Active. false = Inactive (has an end date). attributed_to Object The entity attributed to the infrastructure. guid String [entity_guid] This company’s unique identifier. name String This company’s. ip_count Integer The number of IP addresses. is_suppressed Boolean tags Array Infrastructure tags. Object An infrastructure tag. guid String [entity_guid] The company associated with the tag. id Integer name String The tag name. is_public Boolean Indicates if this tag is public. asn String The autonomous system number. May 17, 2023: Published. Related articles GET: My Infrastructure Companies API Endpoint GET: Assets Infrastructure Data Sources Attack Surface: Infrastructure Feedback 0 comments Please sign in to leave a comment.