VirusTotal API v3 - IoC Investigation

Investigate files, URLs, IP addresses, and domains. Submit and analyse samples, retrieve verdicts, traverse the relationships graph, fetch sandbox behaviour, post comments and votes, search the corpus. The day-one surface for SOC and incident response.

Documentation

Specifications

Other Resources

🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-analyses-submissions-operations.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-attack-tactics.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-attack-techniques.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-comments.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-domains-resolutions.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-files.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-files-behaviours.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-ip-addresses.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-popular-threat-categories.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-search-metadata.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-urls.yaml
🔗
NaftikoCapability
https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/capabilities/ioc-investigation-ioc-investigation-zipping-files.yaml

OpenAPI Specification

virustotal-ioc-investigation-openapi.yml Raw ↑
openapi: 3.0.3
info:
  title: VirusTotal API v3 - IoC Investigation
  version: '3.0'
  description: Investigate files, URLs, IP addresses, and domains. Submit and analyse samples, retrieve reports, get comments and votes, view sandbox behaviour, traverse the relationships graph.
  contact:
    name: VirusTotal / Google Threat Intelligence
    url: https://docs.virustotal.com/reference/overview
  license:
    name: VirusTotal Terms of Service
    url: https://www.virustotal.com/gui/terms-of-service
  x-generated-from: https://storage.googleapis.com/gtidocresources/guides/GTI_API_v3_openapi_spec_10022025.json
  x-last-validated: '2026-05-29'
servers:
- url: https://www.virustotal.com/api/v3
  description: VirusTotal / GTI API v3 production.
security:
- VTApiKey: []
tags:
- name: IoC Investigation - Analyses, Submissions & Operations
  description: IoC Investigation - Analyses, Submissions & Operations
- name: IoC Investigation - Attack Tactics
  description: IoC Investigation - Attack Tactics
- name: IoC Investigation - Attack Techniques
  description: IoC Investigation - Attack Techniques
- name: IoC Investigation - Comments
  description: IoC Investigation - Comments
- name: IoC Investigation - Domains & Resolutions
  description: IoC Investigation - Domains & Resolutions
- name: IoC Investigation - Files
  description: IoC Investigation - Files
- name: IoC Investigation - Files Behaviours
  description: IoC Investigation - Files Behaviours
- name: IoC Investigation - IP addresses
  description: IoC Investigation - IP addresses
- name: IoC Investigation - Popular Threat Categories
  description: IoC Investigation - Popular Threat Categories
- name: IoC Investigation - Search & Metadata
  description: IoC Investigation - Search & Metadata
- name: IoC Investigation - URLs
  description: IoC Investigation - URLs
- name: IoC Investigation - Zipping files
  description: IoC Investigation - Zipping files
paths:
  /analyses/{id}:
    get:
      tags:
      - IoC Investigation - Analyses, Submissions & Operations
      deprecated: false
      description: 'Returns an [Analysis](https://gtidocs.virustotal.com/reference/analyses-object) object.

        '
      operationId: analysis
      parameters:
      - description: Analysis identifier
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get a URL / File Analysis
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /analyses/{id}/relationships/{relationship}:
    get:
      tags:
      - IoC Investigation - Analyses, Submissions & Operations
      deprecated: false
      description: 'This endpoint is the same as [/analyses/{id}/{relationship}](https://gtidocs.virustotal.com/reference/analyses-get-objects) except it returns just the related object''s descriptors (ID
        and context attributes, if any) instead of returning all attributes.

        '
      operationId: analysesGetDescriptors
      parameters:
      - description: Analysis identifier
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:analyses-object#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Object Descriptors Related to an Analysis
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /analyses/{id}/{relationship}:
    get:
      tags:
      - IoC Investigation - Analyses, Submissions & Operations
      deprecated: false
      description: "As mentioned in the [Relationships](https://gtidocs.virustotal.com/reference/relationships) section, those related objects can be retrieved by sending `GET` requests to the relationship\
        \ URL. \n\nAvailable relationships are described in the [analysis](https://gtidocs.virustotal.com/reference/analyses-object) object documentation.\n"
      operationId: analysesGetObjects
      parameters:
      - description: Analysis identifier
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:analyses-object#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Objects Related to an Analysis
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /submission/{id}:
    get:
      tags:
      - IoC Investigation - Analyses, Submissions & Operations
      deprecated: false
      description: 'Returns a [Submission](https://gtidocs.virustotal.com/reference/submission-object) object.

        '
      operationId: getSubmission
      parameters:
      - description: Submission object ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get a Submission Object
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /operations/{id}:
    get:
      tags:
      - IoC Investigation - Analyses, Submissions & Operations
      deprecated: false
      description: 'Returns an [Operation](https://gtidocs.virustotal.com/reference/operation-object) object.

        '
      operationId: getOperationsId
      parameters:
      - description: Operation ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get an Operation Object
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /attack_tactics/{id}:
    get:
      tags:
      - IoC Investigation - Attack Tactics
      deprecated: false
      description: VirusTotal Get an Attack Tactic Object
      operationId: attackTacticsid
      parameters:
      - description: Attack tactic's ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get an Attack Tactic Object
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /attack_tactics/{id}/relationships/{relationship}:
    get:
      tags:
      - IoC Investigation - Attack Tactics
      deprecated: false
      description: 'This endpoint is the same as [/attack_tactics/{id}/{relationship}](https://gtidocs.virustotal.com/reference/attack_tacticsidrelationship) except it returns just the related object''s
        descriptor instead of returning all attributes.

        '
      operationId: attackTacticsidrelationshipsrelationship
      parameters:
      - description: Attack tactic's ID
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:object-attack-tactics#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      - description: Maximum number of related objects to retrieve
        in: query
        name: limit
        schema:
          default: 10
          format: int32
          type: integer
      - description: Continuation cursor
        in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Object Descriptors Related to an Attack Tactic
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /attack_tactics/{id}/{relationship}:
    get:
      tags:
      - IoC Investigation - Attack Tactics
      deprecated: false
      description: 'Available relationships are described in the [Attack Tactic](https://gtidocs.virustotal.com/reference/attack-tactics) object documentation.

        '
      operationId: attackTacticsidrelationship
      parameters:
      - description: Attack tactic's ID
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:object-attack-tactics#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      - description: Maximum number of related objects to retrieve
        in: query
        name: limit
        schema:
          default: 10
          format: int32
          type: integer
      - description: Continuation cursor
        in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Objects Related to an Attack Tactic
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /attack_techniques/{id}:
    get:
      tags:
      - IoC Investigation - Attack Techniques
      deprecated: false
      description: VirusTotal Get an Attack Technique Object
      operationId: attackTechniqueid
      parameters:
      - description: Attack technique's ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get an Attack Technique Object
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /attack_techniques/{id}/relationships/{relationship}:
    get:
      tags:
      - IoC Investigation - Attack Techniques
      deprecated: false
      description: 'This endpoint is the same as [/attack_techniques/{id}/{relationship}](https://gtidocs.virustotal.com/reference/attack_techniqueidrelationship) except it returns just the related object''s
        descriptor instead of returning all attributes.

        '
      operationId: attackTechniquesidrelationshipsrelationship
      parameters:
      - description: Attack technique's ID
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:object-attack-techniques#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      - description: Maximum number of related objects to retrieve
        in: query
        name: limit
        schema:
          default: 10
          format: int32
          type: integer
      - description: Continuation cursor
        in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Object Descriptors Related to an Attack Technique
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /attack_techniques/{id}/{relationship}:
    get:
      tags:
      - IoC Investigation - Attack Techniques
      deprecated: false
      description: 'Available relationships are described in the [Attack Technique](https://gtidocs.virustotal.com/reference/attack-techniques) object documentation.

        '
      operationId: attackTechniqueidrelationship
      parameters:
      - description: Attack technique's ID
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:object-attack-techniques#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      - description: Maximum number of related objects to retrieve
        in: query
        name: limit
        schema:
          default: 10
          format: int32
          type: integer
      - description: Continuation cursor
        in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Objects Related to an Attack Technique
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /comments:
    get:
      tags:
      - IoC Investigation - Comments
      deprecated: false
      description: "This endpoint retrieves information about the latest comments added to Google Threat Intelligence.  \nYou can do some filtering over those comments, and get only those that contains\
        \ a certain tag inside (e.g. filter=tag:malware).\n\n```json Response example\n{\n  \"meta\": {\n    \"cursor\": \"Cs8BChEKBGRhdGUSCQiCnsTiupvwAhK1AWoRc352aXJ1c3RvdGFsY2xvdWRynwELEgNVUkwiQDAxMTkxNTk0MmRiNTU2YmJhYjUxMzdmNzYxZWZlNjFmZWQyYjAwNTk4ZmVhOTAwMzYwYjgwMGIxOTNhN2JmMzEMCxIHQ29tbWVudCJJMDExOTE1OTQyZGI1NTZiYmFiNTEzN2Y3NjFlZmU2MWZlZDJiMDA1OThmZWE5MDAzNjBiODAwYjE5M2E3YmYzMS1kOTRkN2M4YQwYACAB\"\
        \n  },\n  \"data\": [\n    {\n      \"attributes\": {\n        \"votes\": {\n          \"positive\": 0,\n          \"abuse\": 0,\n          \"negative\": 0\n        },\n        \"tags\": [\n   \
        \       \"_:api\",\n          \"_:public\",\n          \"aicc\",\n          \"monitorapp\",\n          \"malware\"\n        ],\n        \"text\": \"#aicc #monitorapp #malware\",\n        \"html\"\
        : \"#aicc #monitorapp #malware\",\n        \"date\": 1619424604\n      },\n      \"type\": \"comment\",\n      \"id\": \"u-011915942db556bbab5137f761efe61fed2b00598fea900360b800b193a7bf31-d94d7c8a\"\
        ,\n      \"links\": {\n        \"self\": \"https://www.virustotal.com/api/v3/comments/u-011915942db556bbab5137f761efe61fed2b00598fea900360b800b193a7bf31-d94d7c8a\"\n      }\n    }\n  ],\n  \"links\"\
        : {\n    \"self\": \"https://www.virustotal.com/api/v3/comments?filter=tag%3Amalware&limit=1\",\n    \"next\": \"https://www.virustotal.com/api/v3/comments?filter=tag%3Amalware&cursor=Cs8BChEKBGRhdGUSCQiCnsTiupvwAhK1AWoRc352aXJ1c3RvdGFsY2xvdWRynwELEgNVUkwiQDAxMTkxNTk0MmRiNTU2YmJhYjUxMzdmNzYxZWZlNjFmZWQyYjAwNTk4ZmVhOTAwMzYwYjgwMGIxOTNhN2JmMzEMCxIHQ29tbWVudCJJMDExOTE1OTQyZGI1NTZiYmFiNTEzN2Y3NjFlZmU2MWZlZDJiMDA1OThmZWE5MDAzNjBiODAwYjE5M2E3YmYzMS1kOTRkN2M4YQwYACAB&limit=1\"\
        \n  }\n}\n```\n"
      operationId: getComments
      parameters:
      - description: Number of items to retrieve
        in: query
        name: limit
        schema:
          default: 10
          format: int32
          type: integer
      - description: Filter returned elements
        in: query
        name: filter
        schema:
          type: string
      - description: Continuation cursor
        in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Latest Comments
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /comments/{id}:
    delete:
      tags:
      - IoC Investigation - Comments
      deprecated: false
      description: VirusTotal Delete a Comment
      operationId: commentIdDelete
      parameters:
      - description: Comment ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Delete a Comment
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    get:
      tags:
      - IoC Investigation - Comments
      deprecated: false
      description: VirusTotal Get a Comment Object
      operationId: getComment
      parameters:
      - description: Relationship name (see [table](ref:comment-object#relationships))
        in: query
        name: relationships
        schema:
          type: string
      - description: Comment ID
        in: path
        name: id
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get a Comment Object
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /comments/{id}/relationships/{relationship}:
    get:
      tags:
      - IoC Investigation - Comments
      deprecated: false
      description: 'This endpoint is the same as [/comments/{id}/{relationship}](https://gtidocs.virustotal.com/reference/comments-relationships) except it returns just the related object''s IDs (and context
        attributes, if any) instead of returning all attributes.

        '
      operationId: commentsRelationshipsIds
      parameters:
      - description: Comment identifier
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:comment-object#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      - description: Maximum number of related objects to retrieve
        in: query
        name: limit
        schema:
          default: '10'
          type: string
      - description: Continuation cursor
        in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Object Descriptors Related to a Comment
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /comments/{id}/vote:
    post:
      tags:
      - IoC Investigation - Comments
      deprecated: false
      description: "```json Example response\n{\n    \"data\": {\n        \"abuse\": 0,\n        \"negative\": 0,\n        \"positive\": 1\n    }\n}\n```\n"
      operationId: voteComment
      parameters:
      - description: Comment ID
        in: path
        name: id
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                data:
                  description: Vote type. Can be either `positive`, `negative` or `abuse`
                  type: string
              required:
              - data
              type: object
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Add a Vote to a Comment
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /comments/{id}/{relationship}:
    get:
      tags:
      - IoC Investigation - Comments
      deprecated: false
      description: 'Comment objects are related to other objects in the Google Threat Intelligence dataset. As mentioned in the [Relationships](https://gtidocs.virustotal.com/reference/relationships) section,
        those related objects can be retrieved by sending `GET` requests to the relationships endpoint.


        All available relationships are documented in the [Comment](https://gtidocs.virustotal.com/reference/comment-object) API object page.

        '
      operationId: commentsRelationships
      parameters:
      - description: Comment identifier
        in: path
        name: id
        required: true
        schema:
          type: string
      - description: Relationship name (see [table](ref:comment-object#relationships))
        in: path
        name: relationship
        required: true
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          description: Bad request.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '401':
          description: Missing or invalid API key.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Object not found.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '429':
          description: Rate limit or quota exceeded.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Objects Related to a Comment
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /domains/{domain}:
    get:
      tags:
      - IoC Investigation - Domains & Resolutions
      deprecated: false
      description: 'Returns a [Domain](https://gtidocs.virustotal.com/reference/domains-object) object.

        '
      operationId: domainInfo
      parameters:
      - description: Domain name
        in: path
        name: domain
        required: true
        schema:
          type: string
      - description: The name of your tool or service. This is required to obtain the gti_assesment data
        in: header
        name: x-tool
        required: false
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: ''
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get a Domain Report
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
  /domains/{domain}/comments:
    get:
      tags:
      - IoC Investigation - Domains & Resolutions
      deprecated: false
      description: 'Returns a list of [Comment](https://gtidocs.virustotal.com/reference/comment-object) objects.

        '
      operationId: domainsCommentsGet
      parameters:
      - description: Domain name
        in: path
        name: domain
        required: true
        schema:
          type: string
      - description: Maximum number of comments to retrieve
        in: query
        name: limit
        schema:
          default: 10
          format: int32
          type: integer
      - description: Continuation cursor
        in: query
        name: cursor
        schema:
          type: string
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '400'
      security:
      - VTApiKey: []
      summary: VirusTotal Get Comments on a Domain
      x-microcks-operation:
        delay: 0
        dispatcher: FALLBACK
    post:
      tags:
      - IoC Investigation - Domains & Resolutions
      deprecated: false
      description: "With this endpoint you can post a comment for a given domain. The body for the POST request must be the JSON representation of a comment object. Notice however that you don't need to\
        \ provide an ID for the object, as they are automatically generated for new comments.\n\nAny word starting with # in your comment's text will be considered a tag, and added to the comment's tag\
        \ attribute.\n\n```json Example request\n{\n  \"data\": {\n    \"type\": \"comment\",\n    \"attributes\": {\n    \t\"text\": \"Lorem #ipsum dolor sit ...\"\n    }\n  }\n}\n```\n\nReturns a [Comment](https://gtidocs.virustotal.com/reference/comment-object)\
        \ object.\n"
      operationId: domainsCommentsPost
      parameters:
      - description: Domain name
        in: path
        name: domain
        required: true
        schema:
          type: string
      requestBody:
        content:
          application/json:
            schema:
              properties:
                data:
                  default: '{"type": "comment", "attributes": {"text": "Lorem ipsum dolor sit ..."}}'
                  description: A comment object
                  format: json
                  type: string
              type: object
      responses:
        '200':
          content:
            application/json:
              examples:
                Result:
                  value: '{}'
              schema:
                properties: {}
                type: object
          description: '200'
        '400':
          content:
         

# --- truncated at 32 KB (905 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/virustotal/refs/heads/main/openapi/virustotal-ioc-investigation-openapi.yml