---
title: "Get graph viewport data"
method: POST
path: "/v3/graph/viewport"
tags: ["Knowledge Graph"]
---

# Get graph viewport data

`POST /v3/graph/viewport`

Fetch documents (with memories) and memory edges within a viewport

## Request body

- object
  - `viewport` object, required
    - `minX` number, required
    - `maxX` number, required
    - `minY` number, required
    - `maxY` number, required
  - `containerTags` string[]
  - `documentIds` string[]
  - `limit` number

## Response `200`

Documents with memories and edges within the viewport

- object
  - `documents` object[], required
    - `id` string, required
    - `title` string, nullable, required
    - `summary` string, nullable, required
    - `documentType` string, required
    - `createdAt` string, required
    - `updatedAt` string, required
    - `x` number, required
    - `y` number, required
    - `memories` object[], required
      - `id` string, required
      - `memory` string, required
      - `isStatic` boolean, required
      - `spaceId` string, required
      - `isLatest` boolean, required
      - `isForgotten` boolean, required
      - `isInference` boolean, required
      - `forgetAfter` string, nullable, required
      - `forgetReason` string, nullable, required
      - `version` number, required
      - `parentMemoryId` string, nullable, required
      - `rootMemoryId` string, nullable, required
      - `sourceCount` number, required
      - `memoryRelations` object, required
      - `changeType` 'created' | 'updated' | 'extended' | 'derived' | 'forgotten', required
      - `createdAt` string, required
      - `updatedAt` string, required
  - `edges` object[], required
    - `source` string, required
    - `target` string, required
    - `similarity` number, required
  - `viewport` object, required
    - `minX` number, required
    - `maxX` number, required
    - `minY` number, required
    - `maxY` number, required
  - `totalCount` number, required

## Other responses

- `400` — Invalid request parameters
- `401` — Unauthorized

## Changes

- **2026-04-07** `b5edd97adf4a` — 2 info
  - api tag `Knowledge Graph` added
  - api tag `Graph` removed
- **2026-03-15** `b40318167017` — 1 breaking
  - request body became required
- **2026-02-13** `1f2624b58aa6` — 4 info
  - added the required property `documents/items/memories/items/changeType` to the response with the `200` status
  - added the required property `documents/items/memories/items/isInference` to the response with the `200` status
  - added the required property `documents/items/memories/items/memoryRelations` to the response with the `200` status
  - added the required property `documents/items/memories/items/sourceCount` to the response with the `200` status
- **2026-02-09** `d09553cd7c35` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/supermemoryai/apis/supermemory-api/changes/v3/graph/viewport/post.md)

---

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