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.