---
title: "Get Identity Graph"
method: GET
path: "/api/v1/identities/{identity_id}/graph"
tags: ["identities"]
---

# Get Identity Graph

`GET /api/v1/identities/{identity_id}/graph`

## Request

- Base URL: `https://api.withverifa.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.withverifa.com/api/v1/identities/{identity_id}/graph`
- Auth: none declared

Query the identity relationship graph with filtering.

Returns a BFS traversal of the identity network starting from the given identity,
with nodes annotated by depth (hop distance from root) and edges annotated by
the depth level at which they were discovered.

## Path parameters

- `identity_id` string, required

## Query parameters

- `depth` integer
- `relationship_types` string, nullable: Comma-separated relationship types to include
- `identity_statuses` string, nullable: Comma-separated identity statuses to include
- `exclude_identity_ids` string, nullable: Comma-separated identity IDs to exclude

## Response `200`

Successful Response

- unknown

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/withverifa/apis/verifa.md) · [All operations](https://skmtc.dev/withverifa/apis/verifa/llms.txt) · [OpenAPI document](https://skmtc.dev/withverifa/apis/verifa/revisions/7288c82c9e33?raw)