> ## Documentation Index > Fetch the complete documentation index at: https://docs.niadra.com/llms.txt > Use this file to discover all available pages before exploring further. # Open an item > One conversation or object opened: what was asked, the promises, the outcome and what it produced. ## OpenAPI ````yaml openapi/en/cell.json GET /v1/history/items/{item_id} openapi: 3.1.0 info: title: Niadra data API version: '1' description: >- Writing, context, history, objects, identity, privacy and governance of one space. Every space has a stable address, with the space and the region in its name. servers: - url: https://{space}.{region}.api.niadra.com variables: space: default: acme-prod description: The space, which comes in the source key. region: default: us-east-1 description: The region of the space, which also comes in the key. security: [] paths: /v1/history/items/{item_id}: get: tags: - read summary: Open an item description: >- One conversation or one business object opened: structured summary, what was asked, what was promised and by whom, outcome, and the memory items that were born from it. The literal excerpt needs an elevated scope. **Authentication.** Source key: `Authorization: Bearer nia_sk_...`. Required scope: `search`. operationId: open_item_v1_history_items__item_id__get parameters: - in: path name: item_id required: true schema: title: Item Id type: string - in: query name: profile_id required: false schema: anyOf: - format: uuid type: string - type: 'null' title: Profile Id - in: query name: verification required: false schema: $ref: '#/components/schemas/Verification' default: V0 - in: query name: conversation_id required: false schema: anyOf: - type: string - type: 'null' title: Conversation Id description: >- The conversation asking, so the verification level of that session applies. responses: '200': content: application/json: schema: $ref: '#/components/schemas/OpenedItem' example: id: ep_01J2 kind: episode summary: Technician did not show up for the scheduled visit. requested: A new visit and compensation promises: - by: company what: New visit on Mar 13, morning due_at: '2026-03-13T15:00:00Z' status: kept outcome: resolved resolution: $40 credit on the April bill derived: [] timeline: [] excerpt: null as_of: '2026-09-22T17:07:02Z' description: The opened item. '422': content: application/problem+json: schema: $ref: '#/components/schemas/Problem' description: The request does not match the contract. security: - sourceKey: [] x-codeSamples: - lang: python label: Python source: |- item = niadra.open("ep_01J2", conversation_id="call-4471") if item: print(item.summary, item.resolution) - lang: typescript label: TypeScript source: >- const { data: item } = await niadra.open("ep_01J2", { conversation_id: "call-4471" }); if (item) console.log(item.summary, item.resolution); components: schemas: Verification: description: Session verification levels. `no_customer` sits outside the V0-V4 scale. enum: - V0 - V1 - V2 - V3 - V4 - no_customer title: Verification type: string OpenedItem: additionalProperties: false properties: as_of: anyOf: - format: date-time type: string - type: 'null' title: As Of derived: items: $ref: '#/components/schemas/HistoryItem' title: Derived type: array description: Memory items that were born from this conversation or object. excerpt: anyOf: - type: string - type: 'null' description: Literal transcript excerpt; needs an elevated scope. title: Excerpt id: title: Id type: string kind: enum: - episode - object title: Kind type: string outcome: anyOf: - type: string - type: 'null' title: Outcome promises: items: $ref: '#/components/schemas/Promise' title: Promises type: array requested: anyOf: - type: string - type: 'null' title: Requested resolution: anyOf: - type: string - type: 'null' title: Resolution summary: title: Summary type: string timeline: items: $ref: '#/components/schemas/HistoryItem' title: Timeline type: array required: - id - kind - summary title: OpenedItem type: object Problem: additionalProperties: false description: RFC 9457 problem details; `code` comes from the versioned error catalog. properties: code: title: Code type: string detail: anyOf: - type: string - type: 'null' default: null title: Detail request_id: anyOf: - type: string - type: 'null' default: null title: Request Id status: title: Status type: integer title: title: Title type: string type: default: about:blank title: Type type: string required: - title - status - code title: Problem type: object HistoryItem: additionalProperties: false properties: at: format: date-time title: At type: string channel: anyOf: - type: string - type: 'null' title: Channel confidence: anyOf: - type: number - type: 'null' title: Confidence id: title: Id type: string kind: title: Kind type: string description: >- One of `episode`, `fact`, `open_item`, `action`, `system_event`, `object`, `trait`. origin_event_id: anyOf: - type: string - type: 'null' title: Origin Event Id description: The event this item came from. outcome: anyOf: - type: string - type: 'null' title: Outcome source_id: anyOf: - type: string - type: 'null' title: Source Id text: title: Text type: string description: Dense text, in the same key-value style as the pack. required: - id - kind - text - at title: HistoryItem type: object Promise: additionalProperties: false properties: by: enum: - company - customer title: By type: string due_at: anyOf: - format: date-time type: string - type: 'null' title: Due At status: title: Status type: string what: title: What type: string required: - by - what - status title: Promise type: object securitySchemes: sourceKey: type: http scheme: bearer description: nia_sk_... ````