v1

latestOpenAPI 3.1.12026-07-242899061.7 MB

Actors Threat Map

Threat Actor Threat Map

Rank threat actors by risk to your primary organization using intent and opportunity scores.

post/map/actors

Request body

actorsstring[]

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.

categoriesstring[]

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.

watchlistsstring[]

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.

Example request

{
  "actors": [
    "l3moPJ"
  ],
  "categories": [
    "GK7qU"
  ],
  "watchlists": [
    "report:Hsxme2"
  ]
}

Response

Example response

{
  "data": {
    "threat_map": [
      {
        "id": "PD_NyL",
        "name": "Nation State Sponsored",
        "alias": [
          "Lorec53 APT Group"
        ],
        "categories": [
          "GK7qU"
        ],
        "intent": 5,
        "opportunity": 25,
        "log_entries": [
          {
            "watchlist": {
              "id": "PD_NyL",
              "name": "Nation State Sponsored"
            },
            "entity": {
              "id": "PD_NyL",
              "name": "Nation State Sponsored"
            },
            "severity": "limited",
            "axis": "opportunity",
            "date": "2023-01-10T14:51:38.462Z"
          }
        ]
      }
    ],
    "date": "2023-01-10T14:51:38.462Z"
  }
}