---
title: "Update field(s) of an alert"
method: PATCH
path: "/alerts/{id}"
tags: ["DTM Alerts"]
---

# Update field(s) of an alert

`PATCH /alerts/{id}`

## Request

- Base URL: `https://www.virustotal.com/api/v3/dtm`
- URL: `https://www.virustotal.com/api/v3/dtm/alerts/{id}`
- Auth: none required

## Path parameters

- `id` string, required

## Headers

- `x-apikey` string, required
- `Accept` string, required
- `Content-Type` string, required

## Request body

- object
  - `status` 'new' | 'read' | 'closed' | 'escalated' | 'in_progress' | 'no_action_required' | 'duplicate' | 'not_relevant' | 'tracked_external'
  - `tags` string[]

## Response `200`

OK

- Alert: An alert is created for each monitor that has at least one matching condition. The alert includes details and context regarding the (raw) document matched, the topics/labels matched from the monitor, as well as the labels and topics identified within the (raw) document.
  - `aggregated_added_at` string, date-time: Only applicable to alert buckets, this field is the timestamp at which the most recent child alert was aggregated into the bucket.
  - `aggregated_alert_count` integer: Only applicable to alert buckets, and indicates the number of alerts aggregated into this bucket alert.
  - `aggregated_alert_count_new` integer: Only applicable to alert buckets, and indicates the number of alerts with new status in this bucket alert.
  - `aggregated_alerts` AggregatedAlertRef[]: Only applciable to alert buckets, this field contains metadata about each child alert aggregated into this bucket.
    - `created_at` string, date-time: The time the child alert was created.
    - `doc_type` string: The document type of the child alert.
    - `has_analysis` boolean: A boolean indicating if the child alert has analysis or file attachments.
    - `id` string: The ID of the aggregated chid alert.
    - `monitor_id` string: The ID of the monitor that generated the child alert.
    - `status` 'new' | 'read' | 'escalated' | 'in_progress' | 'closed' | 'no_action_required' | 'duplicate' | 'not_relevant' | 'tracked_external': The status of the child alert.
    - `tags` string[]: The tags of the child alert.
  - `aggregated_under_id` string: Only applicable to child alerts that are aggregated into a bucket, this field is the ID of the parent bucket alert.
  - `ai_doc_summary` string: If the group has the AI features enabled, this field will contain the AI analysis summary.
  - `alert_summary` string, required: The summary of the alert.
  - `alert_type` 'Compromised Credentials' | 'Domain Discovery' | 'Forum Post' | 'Message' | 'Paste' | 'Shop Listing' | 'Tweet' | 'Web Content', required: The type of this alert.
  - `analysis` string: If analysis has been added to the alert, then this property contains the analysis text.
  - `attachments` FileAttachment[]: File attachments associated with the alert as part of the alert's analysis.
    - `content_type` string: The content type of the file attachment.
    - `created_at` string, date-time: The time the file attachment was created.
    - `created_by_user_id` string: The user ID that created the attachment.
    - `filesize_bytes` integer: The size of the attachment measured in bytes.
    - `id` string: The ID of the file attachment.
    - `name` string: The file name of the attachment.
  - `created_at` string, required: The time this alert was created at.
  - `doc` union
    - Message
      - `__id` string
      - `__type` string
      - `body` string
      - `channel` Channel
        - `__id` string
        - `__type` string
        - `channel_id` string
        - `channel_info` ChannelInfo
          - `description` string
        - `invite_url` string
        - `messenger` Service
          - `__id` string
          - `__type` string
          - `description` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `id` string
          - `inet_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `name` string
          - `software` string
        - `name` string
      - `edit_of` string
      - `in_reply_to` string
      - `ingested` string, date-time
      - `message_id` string
      - `messenger` Service
        - `__id` string
        - `__type` string
        - `description` string
        - `geo_location` GeoLocation
          - `__id` string
          - `__type` string
          - `bbox` GeoShape
            - `coordinates` LocationPoint[]
            - `type` string
          - `city` string
          - `continent_code` string
          - `country` string
          - `country_code` string
          - `country_code_3` string
          - `location` string
          - `postal_code` string
          - `region` string
          - `street_address` StreetAddress
            - `__id` string
            - `__type` string
            - `number` integer
            - `street` string
        - `id` string
        - `inet_location` InetLocation
          - `__id` string
          - `__type` string
          - `domain` string
          - `ips_v4` Ipv4Address[]
          - `ips_v6` Ipv6Address[]
          - `path` string
          - `port` integer
          - `protocol` string
          - `url` string
        - `name` string
        - `software` string
      - `original_id` string
      - `parts` MimePart[]
        - `body` string
        - `content_type` string
        - `filename` string
        - `hashes` Hashes
          - `sha256` string
      - `sender` Profile
        - `__id` string
        - `__type` string
        - `contact` Contact
          - `__id` string
          - `__type` string
          - `aim` string
          - `email` string
          - `email_domain` string
          - `email_redacted` string
          - `fax` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `icq` string
          - `jid` string
          - `msnm` string
          - `phone` string
          - `twitter_handle` string
          - `website` string
        - `created` string, date-time
        - `identity` Identity
          - `__id` string
          - `__type` string
          - `dob` string, date-time
          - `dob_format` string
          - `first_name` string
          - `last_name` string
          - `mmn` string
          - `name` string
          - `ssn` string
        - `language` string
        - `telegram` TelegramProfile
          - `name` string
          - `user_id` integer
        - `twitter` TwitterProfile
          - `__id` string
          - `__type` string
          - `description` string
          - `followers_count` integer
          - `id_str` string
          - `profile_background_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_banner_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_image_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `protected` boolean
          - `statuses_count` integer
          - `user_location` string
          - `verified` boolean
      - `source` string
      - `timestamp` string, date-time
    - Paste
      - `__id` string
      - `__type` string
      - `author` Profile
        - `__id` string
        - `__type` string
        - `contact` Contact
          - `__id` string
          - `__type` string
          - `aim` string
          - `email` string
          - `email_domain` string
          - `email_redacted` string
          - `fax` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `icq` string
          - `jid` string
          - `msnm` string
          - `phone` string
          - `twitter_handle` string
          - `website` string
        - `created` string, date-time
        - `identity` Identity
          - `__id` string
          - `__type` string
          - `dob` string, date-time
          - `dob_format` string
          - `first_name` string
          - `last_name` string
          - `mmn` string
          - `name` string
          - `ssn` string
        - `language` string
        - `telegram` TelegramProfile
          - `name` string
          - `user_id` integer
        - `twitter` TwitterProfile
          - `__id` string
          - `__type` string
          - `description` string
          - `followers_count` integer
          - `id_str` string
          - `profile_background_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_banner_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_image_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `protected` boolean
          - `statuses_count` integer
          - `user_location` string
          - `verified` boolean
      - `body` string
      - `collection_ts` string, date-time
      - `ingested` string, date-time
      - `paste_id` string
      - `service` Service
        - `__id` string
        - `__type` string
        - `description` string
        - `geo_location` GeoLocation
          - `__id` string
          - `__type` string
          - `bbox` GeoShape
            - `coordinates` LocationPoint[]
            - `type` string
          - `city` string
          - `continent_code` string
          - `country` string
          - `country_code` string
          - `country_code_3` string
          - `location` string
          - `postal_code` string
          - `region` string
          - `street_address` StreetAddress
            - `__id` string
            - `__type` string
            - `number` integer
            - `street` string
        - `id` string
        - `inet_location` InetLocation
          - `__id` string
          - `__type` string
          - `domain` string
          - `ips_v4` Ipv4Address[]
          - `ips_v6` Ipv6Address[]
          - `path` string
          - `port` integer
          - `protocol` string
          - `url` string
        - `name` string
        - `software` string
      - `source` string
      - `source_location` InetLocation
        - `__id` string
        - `__type` string
        - `domain` string
        - `ips_v4` Ipv4Address[]
        - `ips_v6` Ipv6Address[]
        - `path` string
        - `port` integer
        - `protocol` string
        - `url` string
      - `timestamp` string, date-time
      - `title` string
    - ShopListing
      - `__id` string
      - `__type` string
      - `batch` ProductBatch
        - `__id` string
        - `__type` string
        - `description` string
        - `name` string
        - `release_date` string, date-time
      - `currency` string
      - `data_availability` DataAvailability
        - `__id` string
        - `__type` string
        - `admin_access_available` boolean
        - `cvc_available` boolean
        - `dob_available` boolean
        - `email_available` boolean
        - `geo_location_available` boolean
        - `mmn_available` boolean
        - `name_available` boolean
        - `phone_available` boolean
        - `pin_available` boolean
        - `pvki_available` boolean
        - `pvv_available` boolean
        - `ssn_available` boolean
        - `track1_available` boolean
        - `track2_available` boolean
        - `vbv_available` boolean
      - `description` string
      - `host_access` HostAccess
        - `host_info` HostInfo
          - `av_installed` boolean
          - `cpu` Cpu
            - `cores` integer
            - `product` string
          - `files` File[]
            - `filename` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `hard_disks` HardDisk[]
            - `size` integer
          - `http_cookies` HttpCookie[]
            - `domain` string
          - `installed_memory` integer
          - `installed_software` Product[]
          - `network_info` NetworkInfo
            - `ad_domain` string
            - `blacklisted_by` Organization[]
            - `domain` string
            - `download_bw` number, float
            - `host_name` string
            - `ipv4` string, ip
            - `is_proxy` boolean
            - `isp` string
            - `partial_ipv4` string, ip
            - `upload_bw` number, float
          - `number_user_accounts` integer
          - `operating_system` string
          - `ransomware_installed` boolean
          - `service_accounts` ServiceAccount[]
            - `created_at` string, date-time
            - `login` string
            - `original_id` string
            - `password` Password
              - …
            - `profile` Profile
              - …
            - `security_questions` SecurityQuestion[]
              - …
            - `service` Service
              - …
            - `service_account_info` ServiceAccountInfo
              - …
          - `sites_visited` InetLocation[]
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `tags` Tag[]
            - `location_point` string
            - `name` string
            - `value` string
          - `uptime` integer
          - `virtualization` string
        - `service_account` ServiceAccount
          - `created_at` string, date-time
          - `login` string
          - `original_id` string
          - `password` Password
            - `encrypted_text` string
            - `encryption_algorithm` string
            - `plain_text` string
          - `profile` Profile
            - `__id` string
            - `__type` string
            - `contact` Contact
              - …
            - `created` string, date-time
            - `identity` Identity
              - …
            - `language` string
            - `telegram` TelegramProfile
              - …
            - `twitter` TwitterProfile
              - …
          - `security_questions` SecurityQuestion[]
            - `answer` string
            - `question` string
          - `service` Service
            - `__id` string
            - `__type` string
            - `description` string
            - `geo_location` GeoLocation
              - …
            - `id` string
            - `inet_location` InetLocation
              - …
            - `name` string
            - `software` string
          - `service_account_info` ServiceAccountInfo
            - `balance` number, float
            - `currency` string
            - `last_transaction_ts` string, date-time
            - `linked_payment_method_description` string
            - `points` integer
      - `host_info` HostInfo
        - `av_installed` boolean
        - `cpu` Cpu
          - `cores` integer
          - `product` string
        - `files` File[]
          - `filename` string
        - `geo_location` GeoLocation
          - `__id` string
          - `__type` string
          - `bbox` GeoShape
            - `coordinates` LocationPoint[]
            - `type` string
          - `city` string
          - `continent_code` string
          - `country` string
          - `country_code` string
          - `country_code_3` string
          - `location` string
          - `postal_code` string
          - `region` string
          - `street_address` StreetAddress
            - `__id` string
            - `__type` string
            - `number` integer
            - `street` string
        - `hard_disks` HardDisk[]
          - `size` integer
        - `http_cookies` HttpCookie[]
          - `domain` string
        - `installed_memory` integer
        - `installed_software` Product[]
        - `network_info` NetworkInfo
          - `ad_domain` string
          - `blacklisted_by` Organization[]
          - `domain` string
          - `download_bw` number, float
          - `host_name` string
          - `ipv4` string, ip
          - `is_proxy` boolean
          - `isp` string
          - `partial_ipv4` string, ip
          - `upload_bw` number, float
        - `number_user_accounts` integer
        - `operating_system` string
        - `ransomware_installed` boolean
        - `service_accounts` ServiceAccount[]
          - `created_at` string, date-time
          - `login` string
          - `original_id` string
          - `password` Password
            - `encrypted_text` string
            - `encryption_algorithm` string
            - `plain_text` string
          - `profile` Profile
            - `__id` string
            - `__type` string
            - `contact` Contact
              - …
            - `created` string, date-time
            - `identity` Identity
              - …
            - `language` string
            - `telegram` TelegramProfile
              - …
            - `twitter` TwitterProfile
              - …
          - `security_questions` SecurityQuestion[]
            - `answer` string
            - `question` string
          - `service` Service
            - `__id` string
            - `__type` string
            - `description` string
            - `geo_location` GeoLocation
              - …
            - `id` string
            - `inet_location` InetLocation
              - …
            - `name` string
            - `software` string
          - `service_account_info` ServiceAccountInfo
            - `balance` number, float
            - `currency` string
            - `last_transaction_ts` string, date-time
            - `linked_payment_method_description` string
            - `points` integer
        - `sites_visited` InetLocation[]
          - `__id` string
          - `__type` string
          - `domain` string
          - `ips_v4` Ipv4Address[]
          - `ips_v6` Ipv6Address[]
          - `path` string
          - `port` integer
          - `protocol` string
          - `url` string
        - `tags` Tag[]
          - `location_point` string
          - `name` string
          - `value` string
        - `uptime` integer
        - `virtualization` string
      - `ingested` string, date-time
      - `is_verified` boolean
      - `item_qty` integer
      - `item_sold` integer
      - `item_type` string
      - `listing_id` string
      - `listing_url` InetLocation
        - `__id` string
        - `__type` string
        - `domain` string
        - `ips_v4` Ipv4Address[]
        - `ips_v6` Ipv6Address[]
        - `path` string
        - `port` integer
        - `protocol` string
        - `url` string
      - `payment_card` PaymentCard
        - `__id` string
        - `__type` string
        - `brand` string
        - `expiry_date` string, date-time
        - `issuer` string
        - `owner` Profile
          - `__id` string
          - `__type` string
          - `contact` Contact
            - `__id` string
            - `__type` string
            - `aim` string
            - `email` string
            - `email_domain` string
            - `email_redacted` string
            - `fax` string
            - `geo_location` GeoLocation
              - …
            - `icq` string
            - `jid` string
            - `msnm` string
            - `phone` string
            - `twitter_handle` string
            - `website` string
          - `created` string, date-time
          - `identity` Identity
            - `__id` string
            - `__type` string
            - `dob` string, date-time
            - `dob_format` string
            - `first_name` string
            - `last_name` string
            - `mmn` string
            - `name` string
            - `ssn` string
          - `language` string
          - `telegram` TelegramProfile
            - `name` string
            - `user_id` integer
          - `twitter` TwitterProfile
            - `__id` string
            - `__type` string
            - `description` string
            - `followers_count` integer
            - `id_str` string
            - `profile_background_location` InetLocation
              - …
            - `profile_banner_location` InetLocation
              - …
            - `profile_image_location` InetLocation
              - …
            - `protected` boolean
            - `statuses_count` integer
            - `user_location` string
            - `verified` boolean
        - `partial_number_prefix` string
        - `partial_number_suffix` string
        - `product` string
        - `service_code` string
        - `type` string
        - `vbv` string
      - `price` number, float
      - `profile` Profile
        - `__id` string
        - `__type` string
        - `contact` Contact
          - `__id` string
          - `__type` string
          - `aim` string
          - `email` string
          - `email_domain` string
          - `email_redacted` string
          - `fax` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `icq` string
          - `jid` string
          - `msnm` string
          - `phone` string
          - `twitter_handle` string
          - `website` string
        - `created` string, date-time
        - `identity` Identity
          - `__id` string
          - `__type` string
          - `dob` string, date-time
          - `dob_format` string
          - `first_name` string
          - `last_name` string
          - `mmn` string
          - `name` string
          - `ssn` string
        - `language` string
        - `telegram` TelegramProfile
          - `name` string
          - `user_id` integer
        - `twitter` TwitterProfile
          - `__id` string
          - `__type` string
          - `description` string
          - `followers_count` integer
          - `id_str` string
          - `profile_background_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_banner_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_image_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `protected` boolean
          - `statuses_count` integer
          - `user_location` string
          - `verified` boolean
      - `publish_ts` string, date-time
      - `seller` Profile
        - `__id` string
        - `__type` string
        - `contact` Contact
          - `__id` string
          - `__type` string
          - `aim` string
          - `email` string
          - `email_domain` string
          - `email_redacted` string
          - `fax` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `icq` string
          - `jid` string
          - `msnm` string
          - `phone` string
          - `twitter_handle` string
          - `website` string
        - `created` string, date-time
        - `identity` Identity
          - `__id` string
          - `__type` string
          - `dob` string, date-time
          - `dob_format` string
          - `first_name` string
          - `last_name` string
          - `mmn` string
          - `name` string
          - `ssn` string
        - `language` string
        - `telegram` TelegramProfile
          - `name` string
          - `user_id` integer
        - `twitter` TwitterProfile
          - `__id` string
          - `__type` string
          - `description` string
          - `followers_count` integer
          - `id_str` string
          - `profile_background_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_banner_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_image_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `protected` boolean
          - `statuses_count` integer
          - `user_location` string
          - `verified` boolean
      - `service_account` ServiceAccount
        - `created_at` string, date-time
        - `login` string
        - `original_id` string
        - `password` Password
          - `encrypted_text` string
          - `encryption_algorithm` string
          - `plain_text` string
        - `profile` Profile
          - `__id` string
          - `__type` string
          - `contact` Contact
            - `__id` string
            - `__type` string
            - `aim` string
            - `email` string
            - `email_domain` string
            - `email_redacted` string
            - `fax` string
            - `geo_location` GeoLocation
              - …
            - `icq` string
            - `jid` string
            - `msnm` string
            - `phone` string
            - `twitter_handle` string
            - `website` string
          - `created` string, date-time
          - `identity` Identity
            - `__id` string
            - `__type` string
            - `dob` string, date-time
            - `dob_format` string
            - `first_name` string
            - `last_name` string
            - `mmn` string
            - `name` string
            - `ssn` string
          - `language` string
          - `telegram` TelegramProfile
            - `name` string
            - `user_id` integer
          - `twitter` TwitterProfile
            - `__id` string
            - `__type` string
            - `description` string
            - `followers_count` integer
            - `id_str` string
            - `profile_background_location` InetLocation
              - …
            - `profile_banner_location` InetLocation
              - …
            - `profile_image_location` InetLocation
              - …
            - `protected` boolean
            - `statuses_count` integer
            - `user_location` string
            - `verified` boolean
        - `security_questions` SecurityQuestion[]
          - `answer` string
          - `question` string
        - `service` Service
          - `__id` string
          - `__type` string
          - `description` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `id` string
          - `inet_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `name` string
          - `software` string
        - `service_account_info` ServiceAccountInfo
          - `balance` number, float
          - `currency` string
          - `last_transaction_ts` string, date-time
          - `linked_payment_method_description` string
          - `points` integer
      - `shop` Service
        - `__id` string
        - `__type` string
        - `description` string
        - `geo_location` GeoLocation
          - `__id` string
          - `__type` string
          - `bbox` GeoShape
            - `coordinates` LocationPoint[]
            - `type` string
          - `city` string
          - `continent_code` string
          - `country` string
          - `country_code` string
          - `country_code_3` string
          - `location` string
          - `postal_code` string
          - `region` string
          - `street_address` StreetAddress
            - `__id` string
            - `__type` string
            - `number` integer
            - `street` string
        - `id` string
        - `inet_location` InetLocation
          - `__id` string
          - `__type` string
          - `domain` string
          - `ips_v4` Ipv4Address[]
          - `ips_v6` Ipv6Address[]
          - `path` string
          - `port` integer
          - `protocol` string
          - `url` string
        - `name` string
        - `software` string
      - `source` string
      - `timestamp` string, date-time
      - `title` string
      - `verification_ts` string, date-time
    - Tweet
      - `__id` string
      - `__type` string
      - `author` Profile
        - `__id` string
        - `__type` string
        - `contact` Contact
          - `__id` string
          - `__type` string
          - `aim` string
          - `email` string
          - `email_domain` string
          - `email_redacted` string
          - `fax` string
          - `geo_location` GeoLocation
            - `__id` string
            - `__type` string
            - `bbox` GeoShape
              - …
            - `city` string
            - `continent_code` string
            - `country` string
            - `country_code` string
            - `country_code_3` string
            - `location` string
            - `postal_code` string
            - `region` string
            - `street_address` StreetAddress
              - …
          - `icq` string
          - `jid` string
          - `msnm` string
          - `phone` string
          - `twitter_handle` string
          - `website` string
        - `created` string, date-time
        - `identity` Identity
          - `__id` string
          - `__type` string
          - `dob` string, date-time
          - `dob_format` string
          - `first_name` string
          - `last_name` string
          - `mmn` string
          - `name` string
          - `ssn` string
        - `language` string
        - `telegram` TelegramProfile
          - `name` string
          - `user_id` integer
        - `twitter` TwitterProfile
          - `__id` string
          - `__type` string
          - `description` string
          - `followers_count` integer
          - `id_str` string
          - `profile_background_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_banner_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `profile_image_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `protected` boolean
          - `statuses_count` integer
          - `user_location` string
          - `verified` boolean
      - `body` string
      - `display_text_range` integer[]
      - `geo_location` GeoLocation
        - `__id` string
        - `__type` string
        - `bbox` GeoShape
          - `coordinates` LocationPoint[]
          - `type` string
        - `city` string
        - `continent_code` string
        - `country` string
        - `country_code` string
        - `country_code_3` string
        - `location` string
        - `postal_code` string
        - `region` string
        - `street_address` StreetAddress
          - `__id` string
          - `__type` string
          - `number` integer
          - `street` string
      - `id_str` string
      - `in_reply_to` string
      - `ingested` string, date-time
      - `is_quote` boolean
      - `language` string
      - `place` GeoLocation
        - `__id` string
        - `__type` string
        - `bbox` GeoShape
          - `coordinates` LocationPoint[]
          - `type` string
        - `city` string
        - `continent_code` string
        - `country` string
        - `country_code` string
        - `country_code_3` string
        - `location` string
        - `postal_code` string
        - `region` string
        - `street_address` StreetAddress
          - `__id` string
          - `__type` string
          - `number` integer
          - `street` string
      - `possibly_sensitive` boolean
      - `quote_count` integer
      - `quoted_status` NestedTweet
        - `__id` string
        - `__type` string
        - `author` Profile
          - `__id` string
          - `__type` string
          - `contact` Contact
            - `__id` string
            - `__type` string
            - `aim` string
            - `email` string
            - `email_domain` string
            - `email_redacted` string
            - `fax` string
            - `geo_location` GeoLocation
              - …
            - `icq` string
            - `jid` string
            - `msnm` string
            - `phone` string
            - `twitter_handle` string
            - `website` string
          - `created` string, date-time
          - `identity` Identity
            - `__id` string
            - `__type` string
            - `dob` string, date-time
            - `dob_format` string
            - `first_name` string
            - `last_name` string
            - `mmn` string
            - `name` string
            - `ssn` string
          - `language` string
          - `telegram` TelegramProfile
            - `name` string
            - `user_id` integer
          - `twitter` TwitterProfile
            - `__id` string
            - `__type` string
            - `description` string
            - `followers_count` integer
            - `id_str` string
            - `profile_background_location` InetLocation
              - …
            - `profile_banner_location` InetLocation
              - …
            - `profile_image_location` InetLocation
              - …
            - `protected` boolean
            - `statuses_count` integer
            - `user_location` string
            - `verified` boolean
        - `body` string
        - `display_text_range` integer[]
        - `geo_location` GeoLocation
          - `__id` string
          - `__type` string
          - `bbox` GeoShape
            - `coordinates` LocationPoint[]
            - `type` string
          - `city` string
          - `continent_code` string
          - `country` string
          - `country_code` string
          - `country_code_3` string
          - `location` string
          - `postal_code` string
          - `region` string
          - `street_address` StreetAddress
            - `__id` string
            - `__type` string
            - `number` integer
            - `street` string
        - `id_str` string
        - `in_reply_to` string
        - `is_quote` boolean
        - `language` string
        - `place` GeoLocation
          - `__id` string
          - `__type` string
          - `bbox` GeoShape
            - `coordinates` LocationPoint[]
            - `type` string
          - `city` string
          - `continent_code` string
          - `country` string
          - `country_code` string
          - `country_code_3` string
          - `location` string
          - `postal_code` string
          - `region` string
          - `street_address` StreetAddress
            - `__id` string
            - `__type` string
            - `number` integer
            - `street` string
        - `possibly_sensitive` boolean
        - `quote_count` integer
        - `quotes` string
        - `recipient` Profile
          - `__id` string
          - `__type` string
          - `contact` Contact
            - `__id` string
            - `__type` string
            - `aim` string
            - `email` string
            - `email_domain` string
            - `email_redacted` string
            - `fax` string
            - `geo_location` GeoLocation
              - …
            - `icq` string
            - `jid` string
            - `msnm` string
            - `phone` string
            - `twitter_handle` string
            - `website` string
          - `created` string, date-time
          - `identity` Identity
            - `__id` string
            - `__type` string
            - `dob` string, date-time
            - `dob_format` string
            - `first_name` string
            - `last_name` string
            - `mmn` string
            - `name` string
            - `ssn` string
          - `language` string
          - `telegram` TelegramProfile
            - `name` string
            - `user_id` integer
          - `twitter` TwitterProfile
            - `__id` string
            - `__type` string
            - `description` string
            - `followers_count` integer
            - `id_str` string
            - `profile_background_location` InetLocation
              - …
            - `profile_banner_location` InetLocation
              - …
            - `profile_image_location` InetLocation
              - …
            - `protected` boolean
            - `statuses_count` integer
            - `user_location` string
            - `verified` boolean
        - `reply_count` integer
        - `retweet_count` integer
        - `source` string
        - `timestamp` string, date-time
        - `tweet_hashtags` TwitterEntityHashtag[]
          - `__id` string
          - `__type` string
          - `hashtag` string
          - `indices` integer[]
        - `tweet_media` TwitterEntityMedia[]
          - `__id` string
          - `__type` string
          - `display_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `expanded_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `indices` integer[]
          - `inet_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `media_id_str` string
          - `media_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `media_type` string
          - `source_status_id_str` string
        - `tweet_symbols` TwitterEntitySymbol[]
          - `__id` string
          - `__type` string
          - `indices` integer[]
          - `text` string
        - `tweet_urls` TwitterEntityUrl[]
          - `__id` string
          - `__type` string
          - `display_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `expanded_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
          - `indices` integer[]
          - `inet_location` InetLocation
            - `__id` string
            - `__type` string
            - `domain` string
            - `ips_v4` Ipv4Address[]
            - `ips_v6` Ipv6Address[]
            - `path` string
            - `port` integer
            - `protocol` string
            - `url` string
        - `tweet_user_mentions` TwitterEntityMention[]
          - `__id` string
          - `__type` string
          - `indices` integer[]
          - `mentioned_user` Profile
            - `__id` string
            - `__type` string
            - `contact` Contact
              - …
            - `created` string, date-time
            - `identity` Identity
              - …
            - `language` string
- … truncated; see the full OpenAPI document linked below

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `500`: Internal Server Error

---

[API](https://skmtc.dev/virustotal/apis/dtm-digital-threat-monitoring.md) - [All operations](https://skmtc.dev/virustotal/apis/dtm-digital-threat-monitoring/llms.txt) - [OpenAPI document](https://skmtc.dev/virustotal/apis/dtm-digital-threat-monitoring/revisions/ba27db660651?raw)
