---
title: "Get Public Graph"
method: GET
path: "/api/v1/graph"
tags: ["graph"]
---

# Get Public Graph

`GET /api/v1/graph`

## Request

- Base URL: `https://api.verdict.finance`
- URL: `https://api.verdict.finance/api/v1/graph`
- Auth: none declared

Every public rated entity, every unrated or private entity an edge points at (a ghost; a private one has no
slug and no name), and the edges with their criticality, rank drag and flags. Free: no drag percentage, no cap
reason, no data gap.

## Headers

- `authorization` string, nullable

## Response `200`

Successful Response

- GraphResponse
  - `built_at` string, required
  - `nodes` GraphNode[], required
    - `id` string, required
    - `type` string, required
    - `slug` string, nullable, required
    - `name` string, nullable, required
    - `rated` boolean, required
    - `grade` string, nullable, required
    - `composite` number, nullable, required
    - `intrinsic_grade` string, nullable, required
    - `intrinsic_composite` number, nullable, required
    - `chains` GraphChain[], required
      - `slug` string, required
      - `name` string, required
    - `withdrawn` boolean, required
    - `matured` boolean, required
    - `private` boolean, required
    - `unrated_inbound` integer, required
    - `recent_moves` GraphMove[], required
      - `computed_at` string, nullable, required
      - `direction` 'up' | 'down', required
      - `prior_grade` string, nullable, required
      - `new_grade` string, required
      - `prior_composite` number, nullable, required
      - `new_composite` number, required
      - `cause` GraphMoveCause, required
        - `kind` string, required
        - `entity_type` string, nullable
        - `entity_slug` string, nullable
        - `entity_name` string, nullable
        - `prior_grade` string, nullable
        - `new_grade` string, nullable
        - `edge_type` string, nullable
        - `criticality` string, nullable
        - `role` string, nullable
        - `via_name` string, nullable
  - `edges` GraphEdge[], required
    - `from` string, required
    - `to` string, required
    - `type` string, required
    - `criticality` string, required
    - `role` 'underlying' | 'collateral', nullable
    - `rank_drag` integer, required
    - `structural_cap` boolean, required
    - `unrated` boolean, required
    - `matured` boolean, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `15de66a17c50`: 1 info
  - added the optional property `nodes/items/recent_moves/items/cause/via_name` to the response with the `200` status

[Operation history](https://skmtc.dev/verdict/apis/verdict-api/changes/api/v1/graph/get.md)

---

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