---
title: "Get an organization's visualizer graph"
method: GET
path: "/v1/organizations/{organization_id}/visualizer_data"
tags: ["organizations"]
---

# Get an organization's visualizer graph

`GET /v1/organizations/{organization_id}/visualizer_data`

## Request

- Base URL: `https://api.ethiack.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.ethiack.com/v1/organizations/{organization_id}/visualizer_data`
- Auth: none declared

Return the asset/IP graph used by the organization visualizer.

Scoped to organization and partner integrators, and gated on the
``visualizer`` entitlement for billing callers. Nodes and links are
assembled from the organization's assets and their IP numbers;
``pentest_slug`` narrows the node set to one pentest's scope in SQL,
so a client does not have to page the scope endpoint and intersect.

Args:
    organization_id (int): Identifier of the organization.
    db (AsyncSession): Request-scoped database session.
    context (ActiveContext): Resolved caller identity and scope.
    pentest_slug (str | None): Optional pentest scope filter.

Returns:
    VisualizerDataResponse: Graph nodes and links for the
        organization.

## Path parameters

- `organization_id` integer, required

## Query parameters

- `pentest_slug` string, nullable: Restrict the graph to the assets in this pentest's scope. Omit for the organization's whole surface.

## Response `200`

Successful Response

- VisualizerDataResponse: Domain hierarchy graph for organization visualization. Attributes: nodes (list[VisualizerNode]): Domain/subdomain nodes. links (list[VisualizerLink]): Parent-child edges.
  - `nodes` VisualizerNode[], required
    - `id` string, required
    - `label` string, required
    - `type` string
    - `findings_count` integer
    - `risk_score` integer
    - `private` boolean
    - `kev` boolean
    - `epss` number, nullable
    - `latitude` number, nullable
    - `longitude` number, nullable
    - `country` string, nullable
    - `is_tld` boolean
  - `links` VisualizerLink[], required
    - `source` string, required
    - `target` string, required

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/ethiack/apis/ethiack-api.md) - [All operations](https://skmtc.dev/ethiack/apis/ethiack-api/llms.txt) - [OpenAPI document](https://skmtc.dev/ethiack/apis/ethiack-api/revisions/4eaba89bfebf?raw)