Items

An item is a concrete piece of knowledge under a topic: a process, a policy, or a fact. To find items, read a topic’s items or use search.

Get an item

GET /v1/items/{id}

Returns the item, its nested child items, and the evidence backing it: verbatim quotes, video timestamps or document character ranges, a confidence score, and links to the original content.

Query parameters

Parameter	Type	Notes
includeHistory	boolean	Include archived and superseded records.

Request

curl "https://api.mereon.ai/v1/items/itm_2c8b" \
  -H "Authorization: Bearer $MEREON_TOKEN"

Response

{
  "id": "itm_2c8b...",
  "topicId": "top_9f2a...",
  "type": "process",
  "title": "Approve an expense over $500",
  "body": "Expenses over $500 require sign-off from the cost-center manager...",
  "parentItemId": null,
  "status": "ACTIVE",
  "supersededById": null,
  "url": "https://mereon.ai/items/itm_2c8b",
  "createdAt": "2026-01-12T09:05:00.000Z",
  "updatedAt": "2026-05-30T16:25:00.000Z",
  "children": [],
  "evidence": [
    {
      "id": "evd_77aa...",
      "contentId": "cnt_44de...",
      "contentTitle": "Finance Handbook",
      "contentType": "document",
      "quote": "Any expense above $500 must be approved by the cost-center manager.",
      "startTime": null,
      "endTime": null,
      "charStart": 10422,
      "charEnd": 10489,
      "confidence": 0.94,
      "url": "https://mereon.ai/content/finance-handbook#10422"
    }
  ]
}

Item fields

Field	Type	Notes
id	string	Item id.
topicId	string	The topic this item belongs to.
type	string	Item kind, for example process, policy, fact. Open set.
title	string	Item title.
body	string | null	Full text of the item, when present.
parentItemId	string | null	Parent item, when this is a sub-step.
children	Item[]	Nested child items, same shape.
evidence	Evidence[]	Source evidence. Present on this detail endpoint.

Evidence fields

Field	Type	Notes
contentId	string	The source content this evidence comes from.
contentTitle	string | null	Title of the source content.
contentType	string | null	For example document or video.
quote	string | null	Verbatim quote from the source, when captured.
startTime endTime	number | null	Video time range in seconds, for video sources.
charStart charEnd	number | null	Character range in the document text, for document sources.
confidence	number	Extraction confidence, 0 to 1.
url	string	Deep link to the source location.