> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bota.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# List Terms Events

> Export this end user's presentation and acceptance evidence

> [!NOTE]
>
> Available in the Platform production API from October 22, 2026, including
> migration 119. Mobile distribution and genuine customer acceptance evidence
> remain separate from API availability.

Read presentation and acceptance events for the exact active EndUser in the
authenticated project. Use a secret project key, a restricted key with
`end_users:read`, or the same EndUser's token. Device, upload and completion
credentials are refused. This grants no organization-wide export access.

Events are returned in ascending keyset order. `limit` is 1–100 and defaults
to 100. When `has_more` is true, pass the returned opaque `next_cursor` unchanged
to obtain the next page. Unknown query fields and malformed cursors are rejected.
Responses use `Cache-Control: no-store`.

Each event includes its version, content hash, server time, subject, project,
channel and `event_type` (`presented` or `accepted`). A presentation event is
not an acceptance. Events store no email, IP address, user agent or session token.

For an audit packet, retrieve the
[immutable document](/api-reference/end-users/terms-document.md) for each event's
version and verify its hash. Do not describe today's document as the wording
accepted in an older event.

Soft deletion refuses current receipt access while retaining prior event rows.
Hard deletion of the subject or project cascades its events. This storage
behavior does not establish an approved retention period or a complete
account-deletion workflow.


## OpenAPI

````yaml GET /end-users/{id}/terms/events
openapi: 3.1.0
info:
  title: Bota API
  description: >-
    API for capturing, ingesting, and processing offline conversations via AI
    wearable devices
  version: 1.0.0
  contact:
    name: Bota Support
    email: support@bota.dev
servers:
  - url: https://api.bota.dev/v1
    description: Production
security:
  - bearerAuth: []
tags:
  - name: End Users
    description: Manage end users (wearable device users)
  - name: Devices
    description: Register, configure, and manage devices
  - name: Recordings
    description: Create and manage audio recordings
  - name: Uploads
    description: Upload and download recording audio files
  - name: Transcriptions
    description: Create and retrieve transcriptions
  - name: Summaries
    description: Create and retrieve AI-generated summaries
  - name: Search
    description: Semantic search over transcript chunks (RAG retrieval)
  - name: AI Ask
    description: Multi-turn Q&A over recordings (single- and cross-recording)
paths:
  /end-users/{id}/terms/events:
    get:
      tags:
        - End Users
      summary: Export Own Terms Events
      description: >-
        Ascending, subject-scoped keyset pagination. No access to another
        project or EndUser. Receipts contain no email, IP address, user agent or
        session token.
      operationId: getEndUsersByIdTermsEvents
      parameters:
        - schema:
            type: string
          required: true
          name: id
          in: path
        - schema:
            type: integer
            minimum: 1
            maximum: 100
          required: false
          name: limit
          in: query
        - schema:
            type: string
          required: false
          name: cursor
          in: query
      responses:
        '200':
          description: Own event page
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: array
                    items:
                      type: object
                      properties:
                        id:
                          type: string
                          format: uuid
                        event_type:
                          type: string
                          enum:
                            - presented
                            - accepted
                        version:
                          type: string
                        content_sha256:
                          type: string
                        recorded_at:
                          type: string
                          format: date-time
                        channel:
                          type: string
                          enum:
                            - portal
                            - bota_one
                            - api
                        subject_type:
                          type: string
                          enum:
                            - dashboard_user
                            - end_user
                        subject_id:
                          type: string
                        project_id:
                          type:
                            - string
                            - 'null'
                      required:
                        - id
                        - event_type
                        - version
                        - content_sha256
                        - recorded_at
                        - channel
                        - subject_type
                        - subject_id
                        - project_id
                  has_more:
                    type: boolean
                  next_cursor:
                    type:
                      - string
                      - 'null'
                required:
                  - data
                  - has_more
                  - next_cursor
        '404':
          description: Not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '423':
          $ref: '#/components/responses/OrganizationAccessQuarantined'
components:
  schemas:
    Error:
      type: object
      properties:
        error:
          type: object
          properties:
            code:
              type: string
            message:
              type: string
          required:
            - code
            - message
      required:
        - error
  responses:
    OrganizationAccessQuarantined:
      description: >-
        Organization access is temporarily locked while an organization deletion
        request is active. The organization owner may cancel the request through
        the dashboard during the grace period.
      headers:
        Cache-Control:
          description: Quarantine responses must not be cached.
          schema:
            type: string
            const: no-store
      content:
        application/json:
          schema:
            type: object
            additionalProperties: false
            required:
              - error
            properties:
              error:
                type: object
                additionalProperties: false
                required:
                  - code
                  - message
                properties:
                  code:
                    type: string
                    const: organization_access_quarantined
                  message:
                    type: string
                    const: Organization access is temporarily locked
                  request_id:
                    type: string
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      description: >-
        API key (sk_live_*, sk_test_*, rk_*), device token (dtok_*), or
        command-bound reset completion credential (rct_*; exact factory-reset
        ACK only)

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.