Security Performance Management
Continuous Monitoring
Cyber Insurance
National Cybersecurity

Articles in this section

See more

GET: Infrastructure Changes

Avatar
Ingrid
Follow
  • April 11, 2022: How to download infrastructure changes as a CSV; Added parameters – format, infrastructure_change_type, q, & sort
  • February 18, 2021: Published.

⇤ Companies

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

See changes in your organization’s infrastructure and details about the change.

  • 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.

Learn more about:

Parameters

*Required.

See query parameters for details on the following parameters:

  • format (Values: csv, json; Default: json)
  • limit (Default: 100)
  • offset (Default: 0)
  • q
  • sort
Parameter Description Values 
change_date
Query 		Filter by when the infrastructure was changed. [String] YYYY-MM-DD 
county
Query 		Filter by country of origin. [String] Two-letter country code. 
company_guid
Path 		Identify the organization to query. [String] Your organization’s unique identifier [entity_guid]. See GET: Portfolio Details. 
infrastructure_change_type
Query 		Filter by change type. [Array]
  • ADDITION = Include infrastructure that is now attributed to the company.
  • EXPIRATION = Include infrastructure that has been end-dated.
  • REMOVAL = Include infrastructure that is no longer present.
  • RENEWAL = Include infrastructure that was end-dated and then re-attributed to the company.
 
infrastructure_type
Query 		Filter by asset type. [String]
  • CIDR
  • domain
 
source
Query 		Filter by the data source. [String] The data source. See infrastructure data sources.

Example Request

To download a CSV of your infrastructure change, include the format parameter with a value of csv (?format=csv). The offset and limit parameters will be ignored.

curl https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/infrastructure/changes -u api_token:

Example Response

{
  "count": 1,
  "links": {
    "next": "https://service.bitsighttech.com/companies/guid/a940bb61-33c4-42c9-9231-c8194c305db3/infrastructure/changes?limit=100&offset=100",
    "prev": null
  },
  "results": [
    {
      "change_date": "2020-12-20",
      "company": {
        "guid": "a940bb61-33c4-42c9-9231-c8194c305db3",
        "name": "Saperix, Inc."
      },
      "country": null,
      "end_date": null,
      "infrastructure": "206.255.90.67",
      "infrastructure_change_type": "REMOVAL",
      "infrastructure_type": "CIDR",
      "prev_end_date": null,
      "source": "User Provided",
      "start_date": "2011-01-01"
    }
  ],
  "summaries": {
    "company": [
      {
        "company": "Saperix, Inc.",
        "guid": "a940bb61-33c4-42c9-9231-c8194c305db3"
      }
    ],
    "country": [
      "IT",
      "TH",
      "US"
    ],
    "source": [
      "APNIC",
      "RIPE",
      "User Provided"
    ]
  }
}

Response Attributes

Field Description 
count
Integer 		The number of changes. 
links
Object 		Navigation for multiple pages of results. See pagination.
  
next
String 		The URL to navigate to the next page of results. 
prev
String 		The URL to navigate to the previous page of results. 
results
Array 		Infrastructure change details.
  
change_date
String [YYYY-MM-DD]		 The date when the change occurred. 
company
Object 		Company details.
  
guid
String [entity_guid]		 The unique identifier of the company. 
name
String 		The name of the company. 
country
String 		The country code of the registration location. 
end_date
String [YYYY-MM-DD]		 The date when the infrastructure stopped being attributed to the company. 
infrastructure
String 		The attributed asset (CIDR block, IP address, or domain name). 
infrastructure_change_type
String 		The type of change. 
infrastructure_type
String 		The type of asset (CIDR or DOMAIN). 
prev_end_date
String [YYYY-MM-DD]		 The date when the infrastructure is no longer active. 
source
String 		The infrastructure data source. 
start_date
String [YYYY-MM-DD]		 The date when the infrastructure was attributed to the company. Depending upon the source of the data, this date might be set to a prior date on which the infrastructure attribution was discovered by our network mapping process.

The 2011-01-01 date is considered as the beginning of time in the Bitsight platform. As a result, many entries use this as a start date.

 
summaries
Object 		Company, country, and source details.
  
company
Array 		Company details.
  
company
String 		The name of this company. 
guid
String [entity_guid]		 The unique identifier of this company. 
country
Array 		The country code of registration locations. 
source
Array 		Infrastructure data sources used to attribute infrastructure.

Related articles