v1

latestOpenAPI 3.1.02026-07-141600153.0 KB

Get objects from the IoC Stream

get/ioc_stream

Query parameters

limitinteger

Number of objects to retrieve (max 40)

descriptors_onlyboolean

The response returns only objects descriptors instead of whole VT objects

filterstring

Filter string

cursorstring

Continuation cursor

orderstring

Sort order

Headers

x-apikeystring required

Your API key

Response

200

Example response

{
  "meta": {
    "cursor": "Ck0KEQoEZGF0ZRIJCLnz1ObJg_0CEjRqEXN-dmlydXN0b3RhbGNsb3Vkch8LEhVJT0NTdHJlYW1Ob3RpZmljYXRpb24YsK2w2iEMGAAgAQ=="
  },
  "data": [
    {
      "type": "file",
      "id": "c9c4ee34d9c9f769f884f720e1d37ce1e864aae1be81a4a274bb1a88704cb11c",
      "context_attributes": {
        "notification_id": "9047905968",
        "origin": "hunting",
        "hunting_info": {
          "rule_name": "vulnerability_weaponization"
        },
        "tags": [
          "c9c4ee34d9c9f769f884f720e1d37ce1e864aae1be81a4a274bb1a88704cb11c"
        ],
        "sources": [
          {
            "type": "hunting_ruleset",
            "id": "7926136120",
            "label": "Ransomware"
          }
        ],
        "notification_date": 1675778611
      }
    }
  ],
  "links": {
    "self": "https://www.virustotal.com/api/v3/ioc_stream?limit=1&filter=date%3A2023-02-07T10%3A00%3A00%2B%20entity_type%3Afile%20origin%3Ahunting&descriptors_only=true",
    "next": "https://www.virustotal.com/api/v3/ioc_stream?filter=date%3A2023-02-07T10%3A00%3A00-+entity_type%3Afile+origin%3Ahunting&cursor=Ck0KEQoEZGF0ZRIJCLnz1ObJg_0CEjRqEXN-dmlydXN0b3RhbGNsb3Vkch8LEhVJT0NTdHJlYW1Ob3RpZmljYXRpb24YsK2w2iEMGAAgAQ%3D%3D&limit=1&descriptors_only=true"
  }
}