---
title: "External System Relationship Graph"
method: GET
path: "/snapshots/{snapshot_id}/external-systems/{package_key}/graph"
tags: ["external-systems"]
---

# External System Relationship Graph

`GET /snapshots/{snapshot_id}/external-systems/{package_key}/graph`

The bounded first-party communities that import one declared package.

## Path parameters

- `snapshot_id` string, required
- `package_key` string, required

## Query parameters

- `scope` 'primary' | 'all'
- `node_limit` integer
- `edge_limit` integer

## Response `200`

Successful Response

- ExternalSystemRelationshipGraphResponse — Bounded aggregate-first relationship graph for one declared package.
  - `package_key` string
  - `package_name` string
  - `package_node_id` string
  - `match_basis` 'exact' | 'subpath' | 'mapped' | 'mixed' | 'unresolved'
  - `matched_external_nodes` ExternalSystemGraphTarget[]
    - `node_id` string, required
    - `match_basis` 'exact' | 'subpath' | 'mapped', required
  - `matched_external_nodes_total` integer
  - `matched_external_nodes_truncated` boolean
  - `evidence_target_limit` integer
  - `evidence_truncated` boolean
  - `nodes` ExternalSystemRelationshipNode[]
    - `aggregate_key` string, required
    - `label` string, required
    - `community_id` integer, required
    - `importing_file_count` integer, required
    - `import_edge_count` integer, required
    - `top_file` string, nullable
  - `edges` ExternalSystemRelationshipEdge[]
    - `source` string, required
    - `target` string, required
    - `import_edge_count` integer, required
  - `aggregate_total` integer
  - `aggregate_returned` integer
  - `edge_total` integer
  - `edge_returned` integer
  - `importing_file_total` integer
  - `import_edge_total` integer
  - `node_limit` integer
  - `edge_limit` integer
  - `truncated` boolean
  - `scope` 'primary' | 'all'
  - `state` string
  - `reason` string, nullable

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/repowise/apis/repowise-hosted-api.md) · [All operations](https://skmtc.dev/repowise/apis/repowise-hosted-api/llms.txt) · [OpenAPI document](https://skmtc.dev/repowise/apis/repowise-hosted-api/revisions/d1694e41a8a1?raw)
