---
title: "Cyber entity graph"
description: "Returns a graph rooted at a CVE, threat actor, or malware family. Requires `rootCveId`, `rootActorId`, or `rootMalwareFamilyId`. Breadth-first search depth is capped at 2."
canonical: https://y2.dev/docs/api/reference/intel/getCyberGraphV2/
---

Endpoint Reference[Intel](https://y2.dev/docs/api/reference/intel)

# Cyber entity graph

Returns a graph rooted at a CVE, threat actor, or malware family. Requires \`rootCveId\`, \`rootActorId\`, or \`rootMalwareFamilyId\`. Breadth-first search depth is capped at 2.

`GET https://api.y2.dev/api/v2/cyber/graph`

- Operation ID: `getCyberGraphV2`
- Required scopes: `intel:cyber`
- Accepts x402 pay-per-request payment
- Contract: https://y2.dev/openapi.json

## Parameters

| Name | In | Type | Required | Description |
| --- | --- | --- | --- | --- |
| `rootCveId` | query | string | No | Root entity ID (kind=cve) for the traversal |
| `rootActorId` | query | string | No | Root entity ID (kind=threat_actor) for the traversal |
| `rootMalwareFamilyId` | query | string | No | Root entity ID (kind=malware_family) for the traversal |
| `depth` | query | integer | No | Maximum BFS depth (1–2) |

## Responses

| Status | Description | Body |
| --- | --- | --- |
| 200 | Cyber graph (nodes + edges) | `CyberGraphResponse` |
| 400 | Invalid request parameters |  |
| 401 | Missing or invalid API key |  |
| 402 | x402 payment required | `X402PaymentRequiredResponse` |
| 403 | Insufficient permissions or access denied |  |
| 429 | Rate limit exceeded (per-key or per-account aggregate) |  |
| 500 | Internal server error |  |

### 200 response fields

| Field | Type | Description |
| --- | --- | --- |
| `data` | `IntelGraph` |  |
| `data.nodes[]` | array of `PublicEntity` |  |
| `data.edges[]` | array of `PublicEntityRelation` |  |
| `data.capped` | boolean | True when traversal stopped early (200-node cap or depth cap) |
| `data.depth` | integer | BFS depth traversed |
| `meta` | `PublicGraphMeta` |  |
| `meta.depth` | integer |  |
| `meta.capped` | boolean |  |