---
updatedAt: 2025-06-04T01:28:04.000Z
agentTools:
  projectIndex: https://securityscorecard.readme.io/v1.7.28/llms.txt
---

# /asi/details/asset/{ip}

# OpenAPI definition

````json
{
  "openapi": "3.0.0",
  "info": {
    "title": "ASI internal service",
    "description": "Attack surface intelligence service",
    "version": "0.0.1"
  },
  "paths": {
    "/asi/details/asset/{ip}": {
      "get": {
        "tags": [
          "asset"
        ],
        "parameters": [
          {
            "required": true,
            "in": "path",
            "name": "ip",
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "IP Full Details",
            "content": {
              "*/*": {
                "schema": {
                  "type": "object",
                  "additionalProperties": false,
                  "properties": {
                    "location": {
                      "type": "object",
                      "additionalProperties": false,
                      "properties": {
                        "hostname": {
                          "type": "string",
                          "description": "Hostname resolution"
                        },
                        "country_name": {
                          "type": "string",
                          "description": "Country"
                        },
                        "country_code": {
                          "type": "string",
                          "description": "Country Code"
                        },
                        "city_name": {
                          "type": "string",
                          "description": "City"
                        },
                        "cloud": {
                          "type": "string",
                          "description": "Cloud provider"
                        },
                        "region": {
                          "type": "string",
                          "description": "Cloud region"
                        },
                        "cidr": {
                          "type": "string",
                          "description": "CIDR"
                        }
                      }
                    },
                    "attribution": {
                      "type": "object",
                      "properties": {
                        "companies": {
                          "type": "array",
                          "description": "List of companies attributed to this asset",
                          "items": {
                            "type": "object",
                            "properties": {
                              "company": {
                                "type": "string",
                                "description": "Company name"
                              },
                              "domain": {
                                "type": "string",
                                "description": "domain"
                              },
                              "scorecard": {
                                "type": "string",
                                "description": "Scorecard id"
                              },
                              "score": {
                                "type": "number",
                                "description": "SSC score"
                              },
                              "industry": {
                                "type": "string",
                                "description": "Industry"
                              },
                              "libraries": {
                                "type": "number",
                                "description": "Libraries Count"
                              }
                            }
                          }
                        }
                      }
                    },
                    "malrep": {
                      "type": "object",
                      "properties": {
                        "maliciousReputation": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "info": {
                                "type": "string",
                                "description": "Name of the malicious reputation"
                              },
                              "last_seen": {
                                "type": "string",
                                "description": "Last time observed"
                              }
                            }
                          }
                        }
                      }
                    },
                    "ports": {
                      "type": "object",
                      "properties": {
                        "ports": {
                          "type": "array",
                          "description": "list of open ports in the asset",
                          "items": {
                            "type": "object",
                            "properties": {
                              "last_seen": {
                                "type": "string",
                                "description": "scan time"
                              },
                              "port": {
                                "type": "string",
                                "description": "port number"
                              },
                              "product": {
                                "type": "string",
                                "description": "product running on the port"
                              },
                              "service": {
                                "type": "string",
                                "description": "service detected on port"
                              },
                              "device_type": {
                                "type": "string",
                                "description": "Device type"
                              },
                              "os_type": {
                                "type": "string",
                                "description": "Os Type"
                              },
                              "cpe": {
                                "type": "array",
                                "description": "CPEs",
                                "items": {
                                  "type": "string"
                                }
                              }
                            }
                          }
                        }
                      }
                    },
                    "ransomware": {
                      "type": "object",
                      "properties": {
                        "ransomwareList": {
                          "type": "array",
                          "description": "Ransomware list",
                          "items": {
                            "type": "object",
                            "properties": {
                              "name": {
                                "type": "string",
                                "description": "Ransomware name"
                              },
                              "victim_name": {
                                "type": "string",
                                "description": "Victim name"
                              },
                              "victim_posted_domain": {
                                "type": "string",
                                "description": "Domain associated to victim"
                              },
                              "last_seen": {
                                "type": "string",
                                "description": "Time when ransomware was detected"
                              }
                            }
                          }
                        }
                      }
                    },
                    "threat_actors": {
                      "type": "object",
                      "properties": {
                        "actors": {
                          "type": "array",
                          "description": "Threat actors associated to this asset",
                          "items": {
                            "type": "object",
                            "additionalProperties": false,
                            "properties": {
                              "actor": {
                                "type": "string",
                                "description": "Threat Actor name"
                              },
                              "origin": {
                                "type": "string",
                                "description": "Origin"
                              },
                              "link_type": {
                                "type": "string",
                                "description": "link type (cve, malware... etc)"
                              },
                              "link": {
                                "type": "string",
                                "description": "Vulnerabilities associated to this threat actor"
                              },
                              "last_seen": {
                                "type": "string",
                                "description": "Last detection"
                              }
                            }
                          }
                        }
                      }
                    },
                    "certs": {
                      "type": "object",
                      "properties": {
                        "certificates": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "hash": {
                                "type": "string",
                                "description": "Certificate Hash"
                              },
                              "status": {
                                "type": "string",
                                "description": "Certificate Status"
                              },
                              "domain": {
                                "type": "string",
                                "description": "Domain associated"
                              }
                            }
                          }
                        }
                      }
                    },
                    "cves": {
                      "type": "object",
                      "properties": {
                        "cves": {
                          "type": "array",
                          "description": "list of CVEs",
                          "items": {
                            "type": "object",
                            "properties": {
                              "cvss": {
                                "type": "number",
                                "description": "CVSS score"
                              },
                              "cve": {
                                "type": "string",
                                "description": "CVE Id"
                              },
                              "maturity": {
                                "type": "string",
                                "description": "Exploit Maturity"
                              },
                              "actor": {
                                "type": "string",
                                "description": "Threat actors using this CVE"
                              },
                              "port": {
                                "type": "number",
                                "description": "Port associated with the CVE"
                              },
                              "last_seen": {
                                "type": "string",
                                "description": "Last detection time"
                              }
                            }
                          }
                        }
                      }
                    },
                    "infections": {
                      "type": "object",
                      "properties": {
                        "activeInfections": {
                          "type": "array",
                          "items": {
                            "type": "object",
                            "properties": {
                              "family": {
                                "type": "string",
                                "description": "Infection family"
                              },
                              "category": {
                                "type": "string",
                                "description": "Infection category"
                              },
                              "last_seen": {
                                "type": "string",
                                "description": "Last time observed"
                              }
                            }
                          }
                        }
                      }
                    }
                  },
                  "description": "IP Full Details"
                }
              }
            }
          }
        }
      }
    }
  },
  "tags": [
    {
      "name": "asset",
      "description": "asset behind the IP address"
    }
  ],
  "security": [
    {
      "Token": []
    }
  ],
  "servers": [
    {
      "url": "//api.securityscorecard.io"
    }
  ],
  "components": {
    "securitySchemes": {
      "Token": {
        "type": "apiKey",
        "in": "header",
        "name": "Authorization",
        "description": "SecurityScorecard API endpoints require an authentication token to be passed\nin an authorization header in order to return data. If you do not already\nhave a token, you can create one by going to the API Access area in your\n[Settings page](https://platform.securityscorecard.io/#/settings/api) and then\nclicking Generate New Token. Please note this tokens have no expiration\nso they can be used until manually revoked. If you have a token and generate\na new one, the previous token will be revoked and can no longer be used.\n\nAdministrators can also revoke API tokens for any user in their account.\n\nOnce you have your token you can pass it in using the `Authorization` http header like this:\n\n```\ncurl -X GET \\\n  https://api.securityscorecard.io/portfolios \\\n  -H 'authorization: Token <your token>'\n```\n"
      }
    }
  },
  "x-readme": {
    "explorer-enabled": true,
    "proxy-enabled": true
  }
}
````