---
title: "Retrieve the Knowledge Graph"
method: GET
path: "/v3/knowledge-graph"
tags: ["Knowledge Graph"]
---

# Retrieve the Knowledge Graph

`GET /v3/knowledge-graph`

## Query parameters

- `nodeID` string
- `maxDepth` integer
- `limit` integer
- `cursor` string
- `type` string[]
- `since` string, date-time
- `search` string
- `bucket` string

## Response `200`

The request has succeeded.

- KnowledgeGraphResponseV3 — Response body for `GET /v3/knowledge-graph`. Pagination is over edges; `nodes` are the distinct endpoint entities of the returned edge page (both endpoints of every edge are included).
  - `nodes` GraphNodeV3[], required — Distinct endpoint entities of the returned edge page.
    - `id` string, required — Stable public identifier for the entity (`ent_...`).
    - `canonical` string, required — Canonical (most descriptive) surface form.
    - `type` string, required — Effective entity type.
    - `mentionCount` integer, required — Total mentions of this entity across all parsed documents.
    - `depth` integer, required — Hops from the center node when the request centers the graph on one entity (`nodeID`). The center is depth 0. When the request is uncentered (no `nodeID`), this is 0 for every node.
  - `edges` GraphEdgeV3[], required — The page of edges.
    - `sourceId` string, required — Source entity public id (`ent_...`).
    - `targetId` string, required — Target entity public id (`ent_...`).
    - `relationType` string, required — Free-form relation label.
    - `mentionCount` integer, required — How many times this edge has been observed.
  - `nextCursor` string — Opaque cursor for the next page of edges, or absent on the last page. Pass it back as `cursor`.

---

[API](https://skmtc.dev/bem-team/apis/bem-api.md) · [All operations](https://skmtc.dev/bem-team/apis/bem-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/bem-team/bem-api/revisions/a6e4624117c6/schema)