GET: Assets

https://api.bitsighttech.com/ratings/v1/companies/company_guid/assets

Parameters

expand

[Query] Include additional information

Value: [String] tag_details, delegated_security_controls, cloud_context, wildcard

Attack Surface Analytics Parameters

cloud_context.provider_slug

[Query] Filter by cloud platform.

Value: [String] Comma-separated cloud provider slugs./strong

cloud_context.region

[Query] Filter by cloud platform region.

Value: [String] Comma-separated cloud provider regions.

cloud_context.service

[Query] Filter by cloud platform service.

Value: [String] Comma-separated cloud services.

Example Response

{

"links":{
   
"next":"https://api.bitsighttech.com/ratings/v1/companies/a940bb61-33c4-42c9-9231-c8194c305db3/assets?limit=100&offset=100",
   "previous":null
 },
 "count":4015,
 "results":[
   […]
   {
     "temporary_id":"tN0i7cUlKZ2e3df1d478e1f9d6da100069f0740915e3896db99bdd2f029566e140671c1683",
     "asset":"12.3.456.789",
     "asset_type":"IP",
     "identifier":null,
     "app_grade":null,
     "ip_addresses":[
       "11.2.333.444"
     ],
     "country_code":"A1",
     "country":"Demo Country 1",
     "hosted_by":{
       "guid":"a5e23bf0-38d4-4cea-aa50-19ee75da481d",
       "name":"Black Hills Technologies"
     },
     "importance":0.0,
     "importance_category":"low",
     "longitude":-123.1234,
     "latitude":12.1234,
     "is_ip":true,
     "services":[
       "HTTP",
       "HTTPS"
     ],
     "origin_subsidiary":{
       "guid":"13b3c162-e597-46da-bac9-7dde651a9b2c",
       "name":"Saperix, Inc - Wifi testing"
     },
     "findings":{
       "total_count":3,
       "counts_by_severity":{
         "severe":0,
         "material":0,
         "moderate":0,
         "minor":3
       }
     },
     "threats":{
       "rolledup_observation_ids":[
         "12345AAbA6Abb_bAAAA7bb==",
         "AAAAbA12bAbAAAbAAbbbbb=="
       ],
       "evidence_keys":[
         "Android 10 / Chrome Mobile WebView 113.0.5672",
         […]
       ]
     },
     "tags":[
       "Guest WiFi",
       "Corporate Network"
     ],
     "tag_details":[
       {
         "guid":"ae87bc30-a3ab-45f7-809f-61ec36978685",
         "name":"Data Center 1",
         "is_inherited":false,
         "is_public":true
       }
     ],
     "overrides":{
       "importance":null
     },
     "combined_overrides":{
       "importance":"low"
     },
     "products":[
       {
         "type":"application",
         "vendor":"blackhillstech",
         "product":"productname",
         "version":null,
         "support":"unknown"
       }
     ],
     "is_monitored":false,
     "cloud_context": {
        "provider": {
            "slug": "aws",
                    "name": "Amazon Web Services"
                },
                "region": "us-east-1",
                "service": "AMAZON"
            }
   }
 ]
}
 

Wildcard Parameters

wildcard.domain_root

[Query] Filter results by wildcard domains

Value: [String] comma-separated list of wildcard domain root values

wildcard.relationship

[Query] Filter results by wildcard relationship

Value: [String] comma-separated list of wildcard relationship values:

• NO_WILDCARD
• WILDCARD_ROOT
• WILDCARD_CHILD

is_wildcard

[Query] Filter results by asset being a wildcard or not

Value: [Boolean]:

• true = include only the assets that are a wildcard

• false = include only the assets that are not a wildcard

Example data within the assets results (2 new keys at the same level as is_monitored or cloud_context):

{
 "is_monitored":false,
 "is_wildcard": true,
 "wildcard": {
   "domain_root": "*.example.com",
   "relationship": {
          "slug": "WILDCARD_ROOT",
          "Name": "Wildcard Root",
   }
 },
 "cloud_context": { ... }
}

Response Attributes

links

next

previous

count

results

cloud_provider

cloud_region

cloud_service