---
title: "Get an Entity's Relations"
method: GET
path: "/v3/entities/{id}/relations"
tags: ["Knowledge Graph"]
---

# Get an Entity's Relations

`GET /v3/entities/{id}/relations`

## Path parameters

- `id` string, required

## Query parameters

- `direction` 'inbound' | 'outbound' | 'both'
- `relationType` string
- `limit` integer
- `cursor` string
- `bucket` string

## Response `200`

The request has succeeded.

- EntityRelationsResponseV3 — Response body for `GET /v3/entities/{id}/relations`.
  - `inbound` InboundRelationV3[], required — Edges pointing at the queried entity.
    - `relationType` string, required — Free-form relation label (e.g. `author_of`, `affiliated_with`).
    - `sourceEntity` RelatedEntityV3, required — A compact view of an entity sitting on the far end of a relation edge — the stable public id, the canonical name, and the effective type. The full entity is fetched separately via the entity detail / File System endpoints.
      - `id` string, required — Stable public identifier for the entity (`ent_...`).
      - `canonical` string, required — Canonical (most descriptive) surface form of the entity.
      - `type` string, required — Effective entity type.
      - `depth` integer, required — Hops from the queried entity. This endpoint returns direct relations, so this is 1 (a self-loop's far end is the queried entity itself, 0).
    - `mentionCount` integer, required — How many times this edge has been observed across parsed documents.
    - `firstSeenAt` string, date-time, required — First-seen timestamp of the edge (RFC 3339).
  - `outbound` OutboundRelationV3[], required — Edges pointing away from the queried entity.
    - `relationType` string, required — Free-form relation label (e.g. `author_of`, `affiliated_with`).
    - `targetEntity` RelatedEntityV3, required — A compact view of an entity sitting on the far end of a relation edge — the stable public id, the canonical name, and the effective type. The full entity is fetched separately via the entity detail / File System endpoints.
      - `id` string, required — Stable public identifier for the entity (`ent_...`).
      - `canonical` string, required — Canonical (most descriptive) surface form of the entity.
      - `type` string, required — Effective entity type.
      - `depth` integer, required — Hops from the queried entity. This endpoint returns direct relations, so this is 1 (a self-loop's far end is the queried entity itself, 0).
    - `mentionCount` integer, required — How many times this edge has been observed across parsed documents.
    - `firstSeenAt` string, date-time, required — First-seen timestamp of the edge (RFC 3339).
  - `nextCursor` string — Opaque cursor for the next page of edges, or absent on the last page. Pass it back as `cursor`.

---

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