---
title: "List graphs"
method: GET
path: "/v1/graphs"
tags: ["KG API"]
---

# List graphs

`GET /v1/graphs`

Retrieve a list of Knowledge Graphs.

## Query parameters

- `order` 'asc' | 'desc'
- `before` string, uuid
- `after` string, uuid
- `limit` integer

## Response `200`

- GraphsResponse
  - `data` Graph[], required
    - `id` string, uuid, required — The unique identifier of the Knowledge Graph.
    - `created_at` string, date-time, required — The timestamp when the Knowledge Graph was created.
    - `name` string, required — The name of the Knowledge Graph.
    - `description` string — A description of the Knowledge Graph.
    - `file_status` GraphFileStatus, required
      - `in_progress` integer, required — The number of files currently being processed.
      - `completed` integer, required — The number of files that have been successfully processed.
      - `failed` integer, required — The number of files that failed to process.
      - `total` integer, required — The total number of files associated with the Knowledge Graph.
    - `type` 'manual' | 'connector' | 'web', required — The type of Knowledge Graph: - `manual`: files are uploaded via UI or API - `connector`: files are uploaded via a data connector such as Google Drive or Confluence - `web`: URLs are connected to the Knowledge Graph
    - `urls` WebConnectorUrl[] — An array of web connector URLs associated with this Knowledge Graph.
      - `url` string, required — The URL to be processed by the web connector.
      - `status` WebConnectorUrlState, required — The state of a web connector URL processing.
        - `status` 'validating' | 'success' | 'error', required — The status of web connector URL processing.
        - `error_type` 'invalid_url' | 'not_searchable' | 'not_found' | 'paywall_or_login_page' | 'unexpected_error' — The type of error that can occur during web connector URL processing.
      - `exclude_urls` string[] — An array of URLs to exclude from processing within this web connector.
      - `type` 'single_page' | 'sub_pages', required — The type of web connector processing for a URL.
  - `first_id` string, uuid — The ID of the first Knowledge Graph in the current response.
  - `last_id` string, uuid — The ID of the last Knowledge Graph in the current response.
  - `has_more` boolean, required — Indicates if there are more Knowledge Graphs available beyond the current page.

## Changes

- **2025-08-12** `0bbaae2a6920` — 1 warning, 1 info
  - added the new `web` enum value to the `data/items/type` response property for the response status `200`
  - added the optional property `data/items/urls` to the response with the `200` status
- **2025-02-25** `3d3b2fe43375` — 1 info
  - added the required property `data/items/type` to the response with the `200` status

[Change history](https://skmtc.dev/writer/apis/api/changes/v1/graphs/get.md)

---

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