This endpoint is the same as /threat_profiles/{profile_id}/{relationship} except it returns just the related object's descriptor instead of returning all attributes.

Available relationships are described in the Threat Profiles object Relationships section.

This endpoint requires the user to be the owner or an editor of the Threat Profile to be able to see users and groups with access to the Threat Profile.

Examples

Get the descriptors of 3 users and groups that have edition privileges on my Threat Profile with 332e02da667746f180a9740e94a3ec98 identifier.

import requests

profile_id = "332e02da667746f180a9740e94a3ec98"
relationship = "editors"
limit = 3

url = f"https://www.virustotal.com/api/v3/threat_profiles/{profile_id}/relationships/{relationship}?limit={limit}"
headers = {
    "accept": "application/json","x-apikey": <api-key>
}
response = requests.get(url, headers=headers)

Get the descriptors of all users and groups that have viewer privileges on my Threat Profile with 332e02da667746f180a9740e94a3ec98 identifier.

import requests

profile_id = "332e02da667746f180a9740e94a3ec98"
relationship = "viewers"

url = f"https://www.virustotal.com/api/v3/threat_profiles/{profile_id}/relationships/{relationship}"
headers = {
    "accept": "application/json","x-apikey": <api-key>
}
response = requests.get(url, headers=headers)