---
title: "GET /ego_network_visualisation/{entityId}"
method: GET
path: "/ego_network_visualisation/{entityId}"
tags: ["Proposal"]
---

# GET /ego_network_visualisation/{entityId}

`GET /ego_network_visualisation/{entityId}`

Retrieves a list of object with id, system_class, label and related ids connected to one entity.

## Path parameters

- `entityId` integer, required

## Query parameters

- `depth` integer
- `exclude_system_classes` string[]
- `linked_to_ids` integer[]
- `download` boolean

## Response `200`

Success

- NetworkVisualisationModel
  - `results` object[], required
    - `id` number, required
    - `label` string, required
    - `systemClass` string, required
    - `typeIds` number[], required
    - `relations` number[], required

## Other responses

- `400` — Bad Request
- `401` — Unauthorized
- `403` — Access denied
- `404` — Resource not found
- `409` — Conflict
- `500` — Internal server error

## Changes

- **2026-05-08** `c089d40a7a9e` — 2 breaking
  - `path` request parameter `entityId` list-of-types was narrowed by removing types `string`
  - for the `path` request parameter `entityId`, the type changed from no type to `integer`
- **2026-05-06** `5f6c0a42ab14` — 2 info
  - `path` request parameter `entityId` list-of-types was widened by adding types `string`
  - for the `path` request parameter `entityId`, the type was generalized from `integer` to no type
- **2026-02-17** `344dcb617089` — 1 info
  - added the required property `results/items/typeIds` to the response with the `200` status
- **2025-12-03** `008688998b83` — 6 breaking, 1 info
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `401`
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `403`
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `404`
  - the `allOf[#/components/schemas/ApiError]/url` response's property format changed from `uri` to no format for status `409`
  - …3 more
- …earlier changes not shown

[Full history](https://skmtc.dev/craws/apis/openatlas-api/changes/ego_network_visualisation/:entityId/get.md)

---

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