References

A reference represents a URL related to a collection, or IOCs.

Object Attributtes

author: <string> author of the reference.
creation_date: <integer> creation date of the reference (UTC timestamp).
last_modification_date: <integer> date when the reference was last updated (UTC timestamp).
title: <string> title of the reference.
url: <string> URL of the reference.

{
  "data": {
    "attributes": {
      "author": <string>,
      "creation_date": <int>,
      "last_modification_date": <int>,
      "title": <string>,
      "url": <string>
    },
    "type": "reference",
    "id": <string>,
    "links": {
      "self": "https://www.virustotal.com/api/v3/references/<id>"
    }
  }
}

{
  "data": {
    "attributes": {
      "last_modification_date": 1611834034,
      "url": "https://securitysummitperu.com/articulos/confirman-ataques-de-shamoon-v3-dirigidos-a-la-industria-de-petroleo-y-gas-en-medio-oriente-y-europa/",
      "creation_date": 1545242193,
      "author": "Security Summit",
      "title": "Confirman ataques de Shamoon V3 dirigidos a la industria de petróleo y gas en Medio Oriente y Europa"
    },
    "type": "reference",
    "id": "654abe7f0999204c28dc9c120182f98867b35483970331805315c6b6700edb7a",
    "links": {
      "self": "https://www.virustotal.com/api/v3/references/654abe7f0999204c28dc9c120182f98867b35483970331805315c6b6700edb7a"
    }
  }
}

Relationships

In addition to the previously described attributes, reference objects contain relationships with other objects in our dataset that can be retrieved as explained in the Relationships section.

The following table shows a summary of available relationships.

Relationship	Return object type
collections	List of Collections
domains	List of Domains
files	List of Files
ip_addresses	List of IP addresses
threat_actors	List of Threat Actors
urls	List of URLs