---
title: "List nodes in a KG"
method: GET
path: "/api/v0/knowledge-bases/{kb_id}/graph/nodes"
tags: ["Knowledge Base Graph"]
---

# List nodes in a KG

`GET /api/v0/knowledge-bases/{kb_id}/graph/nodes`

## Request

- Base URL: `https://api.outerport.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.outerport.com/api/v0/knowledge-bases/{kb_id}/graph/nodes`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/outerport/apis/outerport-api/docs/api/v0/knowledge-bases/:kb_id/graph/nodes/get.ts> (a function with typed inputs; its response is checked against the schema)

All nodes in the KG, optionally narrowed to a tier ('representation' | 'domain') and/or a type_id.

## Path parameters

- `kb_id` string, uuid, required

## Query parameters

- `tier` 'representation' | 'domain', nullable: Narrow to one ontology tier.
- `type_id` string, nullable: Narrow to one entity type id.

## Response `200`

Successful Response

- NodeResponse[]
  - `id` string, uuid, required
  - `knowledge_base_id` string, uuid, required
  - `tier` 'representation' | 'domain', required
  - `type_id` string, required
  - `name` string, required
  - `attributes` object, required
  - `derived` object
  - `selector` NodeSelector
  - `reads_fields` boolean: Whether this occurrence records attribute values a collection reading read from its source (as opposed to values recorded as attribute claims).
  - `confidence` number, nullable
  - `source` string, required
  - `created_at` string, date-time, required
  - `updated_at` string, date-time, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-11-09** `ecd5b922e78a`: 1 info
  - added the optional property `items/reads_fields` to the response with the `200` status
- **2026-09-25** `fcd15f6d35b4`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/outerport/apis/outerport-api/changes/api/v0/knowledge-bases/:kb_id/graph/nodes/get.md)

---

[API](https://skmtc.dev/outerport/apis/outerport-api.md) - [All operations](https://skmtc.dev/outerport/apis/outerport-api/llms.txt) - [OpenAPI document](https://skmtc.dev/outerport/apis/outerport-api/revisions/08b5bf6f7f18?raw)