---
updatedAt: 2026-10-07T13:42:04.000Z
agentTools:
  projectIndex: https://virustotal.readme.io/llms.txt
---

# Get an IP address report

> 🚧 IoC scanning and dataset inclusion
>
> Any IoC submitted or queried via the API will be scanned and added to the VirusTotal dataset, making it accessible to the community. Do not submit or query indicators containing sensitive, confidential, or personally identifiable information (PII).

Returns an [IP address](https://virustotal.readme.io/reference/ip-object) object.

> 📘 Ports and services
>
> Open ports, the services and technologies running on them and the vulnerabilities that affect them are available through the `port_info` attribute of the [IP address object](https://virustotal.readme.io/reference/ip-object), [Get the technologies detected on an IP address](https://virustotal.readme.io/reference/ip-scanning-technologies), and the [Port Info](https://virustotal.readme.io/reference/port-info-object) and [Port Analysis](https://virustotal.readme.io/reference/port-analysis-object) endpoints in the Ports & Services section.

# OpenAPI definition

```json
{
  "openapi": "3.1.0",
  "info": {
    "title": "virustotal-api-v3",
    "version": "3.0"
  },
  "servers": [
    {
      "url": "https://www.virustotal.com/api/v3"
    }
  ],
  "security": [
    {}
  ],
  "paths": {
    "/ip_addresses/{ip}": {
      "get": {
        "summary": "Get an IP address report",
        "description": "",
        "operationId": "ip-info",
        "parameters": [
          {
            "name": "ip",
            "in": "path",
            "description": "IP address",
            "schema": {
              "type": "string"
            },
            "required": true
          },
          {
            "name": "x-apikey",
            "in": "header",
            "description": "Your API key",
            "required": true,
            "schema": {
              "type": "string"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "200",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          },
          "400": {
            "description": "400",
            "content": {
              "application/json": {
                "examples": {
                  "Result": {
                    "value": "{}"
                  }
                },
                "schema": {
                  "type": "object",
                  "properties": {}
                }
              }
            }
          }
        },
        "deprecated": false,
        "security": []
      }
    }
  },
  "x-readme": {
    "headers": [],
    "explorer-enabled": true,
    "proxy-enabled": false
  },
  "x-readme-fauxas": true
}
```