Get objects related to a Threat Profile

This endpoint returns available relationships that 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 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}/{relationship}?limit={limit}"
headers = {
    "accept": "application/json","x-apikey": <api-key>
}
response = requests.get(url, headers=headers)

Get 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}/{relationship}"
headers = {
    "accept": "application/json","x-apikey": <api-key>
}
response = requests.get(url, headers=headers)

Path Params
string
required

Threat Prfile's ID

string
required

Relationship name from threat profile relationships section

Query Params
int32
0 to 40
Defaults to 10

Maximum number of related objects to retrieve (max 40)

string

Continuation cursor

Headers
string
required

Your API key

Responses

Language
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json