GET: Infrastructure Changes

Ingrid

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

change_date

[Query] Filter by when the infrastructure was changed.

Value: [String] YYYY-MM-DD

county

[Query] Filter by country of origin.

Value: [String] Two-letter country code.

company_guid

* Required.

[Path] Identify the organization to query.

Value: [String] Your organization’s unique identifier [entity_guid]. See GET: Portfolio Details.

infrastructure_change_type

[Query] Filter by change type.

Value: [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.

Value: [String]

CIDR
domain

source

[Query] Filter by the data source.

Value: [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.

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