Threat Actor Threat Map for Organization

Rank threat actors by risk to a specific organization in a multi-org enterprise.

What this endpoint does

Returns the threat actor threat map for a specific organization in a multi-org enterprise. Identical in structure to Threat Actor Threat Map but requires an explicit orgId path parameter. Obtain valid orgId values (uhash format, e.g., uhash:5XdwuI1B1E) from the organization.id field in Available Threat Maps. Filter by actor entity IDs (from Threat Actor Search), category IDs (from Threat Actor Categories), or watchlist IDs.

Response data

Returns a prioritized assessment of which threat actors pose the greatest risk to your specific organization. Each actor carries intent and opportunity scores (0–100) reflecting how likely they are to target your organization and how capable they are of doing so — higher scores in both dimensions mean higher priority. Log entries are the evidence trail: each one links a threat actor to your organization's watchlists (tech stack, methods, target sectors) via specific entities (CVEs, MITRE techniques, malware tools), with severity ratings and the axis of relevance (capability, intent, or opportunity). Use this to brief leadership on your organization's threat landscape or to prioritize which actors warrant hunting campaigns. The response can be large (hundreds of KB) when many actors match your watchlists.

Path Params
string
required

The entity ID of the organization for which to fetch the threat map. The calling user must have access to this organization.

Body Params

Threat map filters

actors
array of strings

An array of threat actor entity IDs. If used, the API response will be limited to only those threat actors whose entity IDs match those found in the array. To lookup a threat actor entity ID, use the /actor/search endpoint.

actors
categories
array of strings

An array of threat actor category entity IDs. If used, the API response will be filtered to only those threat actors whose category (e.g., Hacktivist, Financially motivated, Nation-state sponsored) matches those found in the array. Categories must be listed by their Recorded Future Entity ID, which can be found by using the /actor/categories endpoint.

categories
watchlists
array of strings

An array of client specific watch list IDs. If used, the API response will be limited to only those threat actors whose link to the threat map is via the watch lists included. To lookup a watch list ID, use the List API.

watchlists
Response

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