List facts in a POT

List facts within a POT, with filtering (POT Score range, domain, tags, source document, status), sorting (created_at, updated_at, pot_score), and cursor-based pagination. Returns each fact with its current POT Score, level (e.g., VERIFIED, SUPPORTED), provenance, and an edge_summary block counting incoming/outgoing edges by type.

Common use cases:

Browsing facts by certainty (min_pot_score=0.8 for VERIFIED+).
Auditing a single source document's extracted facts (document_id=...).
Building a Curator review queue (filter by status=pending).
Powering an internal knowledge browser.

Pagination: cursor-based. First request omits cursor; subsequent requests pass back the next_cursor from the prior response. Cursors are opaque tokens — do not parse or construct them. Changing filters or sort mid-pagination returns 400; start a new pagination from page 1.

Total count: by default the response omits total (saves one Query per page). Pass include_total=true if you need it for a 'Showing N of M' display, or call GET /pots/{pot_id}/stats for richer counts.

pot_idstring uuid required

min_pot_scorenumber nullable

max_pot_scorenumber nullable

document_idstring uuid nullable

Filter by source document UUID

domainstring nullable

statusstring nullable

tagsstring[]

sort_by'created_at' | 'updated_at' | 'pot_score'

sort_order'asc' | 'desc'

limitinteger

cursorstring nullable

Opaque pagination cursor

include_totalboolean

Set to true to include total in the response. Adds one Query per page; default is false for performance.

Response

Facts retrieved successfully

pot_idstring uuid required

totalinteger nullable

Total facts matching filters (uncapped). Only populated when the request opts in via ?include_total=true.

limitinteger required

Page size requested

next_cursorstring nullable

Opaque cursor for the next page, or null when there are no more results.

has_moreboolean required

Whether more results exist beyond this page

v2

List facts in a POT

Path parameters

Query parameters

Response