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

# Export Assistant conversation by ID (reporting)

> Retrieve one Assistant conversation by ID in the transcript-free reporting format.

Use this endpoint when you already know the conversation ID. It searches the tenant's retained Assistant reporting records and returns the same row format as the [list endpoint](https://docs.crescendo.ai/api-reference/endpoint/reporting-botconv.md), without message content or a pagination envelope.

```bash theme={null}
export CRESCENDO_TENANT_ID="tenant-alpha"
export CRESCENDO_CONVERSATION_ID="conversation-42"
export CRESCENDO_API_KEY="YOUR_API_KEY"

curl -sS \
  -H "Authorization: Bearer $CRESCENDO_API_KEY" \
  "https://platform.crescendo.ai/api/v1/reporting/tenants/$CRESCENDO_TENANT_ID/assistant/conversations/$CRESCENDO_CONVERSATION_ID"
```

The response includes `BotVersion`. Its value is `null` when the stored legacy reporting document does not contain revision metadata.

If the conversation ID is not present for the tenant, the endpoint returns `404 Not Found`.


## OpenAPI

````yaml GET /api/v1/reporting/tenants/{tenantId}/assistant/conversations/{convId}
openapi: 3.1.0
info:
  title: Crescendo Platform API
  version: 1.6.0
  description: Public HTTP API for the Crescendo platform.
servers:
  - url: https://platform.crescendo.ai
security:
  - bearerAuth: []
  - bearerTokenQuery: []
tags:
  - name: Service
    description: Service metadata and health.
  - name: Provisioning
    description: Tenant-scoped provisioning resources.
  - name: Assistants
    description: Customer messages and assistant handoff results.
  - name: Reporting
    description: Reporting-friendly exports (cursor pagination).
  - name: VOC
    description: Upload recordings for VOC processing.
  - name: MCP
    description: Model Context Protocol (MCP) endpoints.
paths:
  /api/v1/reporting/tenants/{tenantId}/assistant/conversations/{convId}:
    get:
      tags:
        - Reporting
      summary: Export assistant conversation by ID (reporting)
      description: >-
        Returns one assistant conversation in the same reporting-friendly row
        format as the list endpoint, without message content.
      operationId: getReportingBotConversation
      parameters:
        - $ref: '#/components/parameters/tenantId'
        - $ref: '#/components/parameters/convId'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/BotConversationRow'
        '401':
          $ref: '#/components/responses/Unauthenticated'
        '403':
          $ref: '#/components/responses/PermissionDenied'
        '404':
          $ref: '#/components/responses/NotFound'
        '503':
          $ref: '#/components/responses/Unavailable'
components:
  parameters:
    tenantId:
      name: tenantId
      in: path
      required: true
      description: Tenant identifier.
      schema:
        type: string
    convId:
      name: convId
      in: path
      required: true
      description: Assistant conversation identifier.
      schema:
        type: string
  schemas:
    BotConversationRow:
      type: object
      description: >-
        Reporting row for a assistant conversation. Keys are optimized for
        reporting/exports.
      properties:
        ID:
          type:
            - string
            - 'null'
        TenantID:
          type:
            - string
            - 'null'
        BotID:
          type:
            - string
            - 'null'
        BotName:
          type:
            - string
            - 'null'
        BotVersion:
          type:
            - string
            - 'null'
          description: >-
            Stored bot revision; null for a legacy reporting document without
            revision metadata.
        Datetime:
          type:
            - integer
            - 'null'
          format: int64
          description: Epoch milliseconds.
        EndDatetime:
          type:
            - integer
            - 'null'
          format: int64
          description: Epoch milliseconds.
        DatetimeUTC:
          type:
            - string
            - 'null'
          format: date-time
        EndDatetimeUTC:
          type:
            - string
            - 'null'
          format: date-time
        Duration:
          type: integer
          format: int32
          description: Duration in seconds.
        Escalated:
          type:
            - boolean
            - 'null'
        escalatedAt:
          type:
            - integer
            - 'null'
          format: int64
          description: Epoch milliseconds from `state.escalatedAt`.
        CSat:
          type:
            - number
            - 'null'
        AgentName:
          type:
            - string
            - 'null'
        AgentId:
          type:
            - string
            - integer
            - 'null'
        AgentEmail:
          type:
            - string
            - 'null'
        Category:
          type:
            - string
            - 'null'
        Subcategory:
          type:
            - string
            - 'null'
        Tertiary:
          type:
            - string
            - 'null'
        RemoteIp:
          type:
            - string
            - 'null'
        userAgent:
          type:
            - string
            - 'null'
        Referrer:
          type:
            - string
            - 'null'
        Media:
          oneOf:
            - type: string
            - type: array
              items:
                type: string
            - type: 'null'
        Summary:
          type:
            - string
            - 'null'
        Handoff Reason:
          type:
            - string
            - 'null'
        ticketId:
          type:
            - string
            - integer
            - 'null'
        ticketUrl:
          type:
            - string
            - 'null'
        ticketKind:
          type:
            - string
            - 'null'
        Input:
          type:
            - string
            - 'null'
        Contact Name:
          type:
            - string
            - 'null'
        Contact Email:
          type:
            - string
            - 'null'
        Contact Phone:
          type:
            - string
            - 'null'
      required:
        - ID
        - TenantID
        - BotID
        - BotName
        - BotVersion
        - Datetime
        - EndDatetime
        - DatetimeUTC
        - EndDatetimeUTC
        - Duration
    ErrorResponse:
      type: object
      properties:
        code:
          type: string
        message:
          type: string
      required:
        - code
        - message
  responses:
    Unauthenticated:
      description: Unauthenticated
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            example:
              value:
                code: Unauthenticated
                message: Authorization header with Bearer token is required
    PermissionDenied:
      description: Permission denied
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            example:
              value:
                code: PermissionDenied
                message: API key does not allow this operation
    NotFound:
      description: Not found
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            example:
              value:
                code: NotFound
                message: Resource not found
    Unavailable:
      description: Upstream dependency unavailable
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          examples:
            example:
              value:
                code: Unavailable
                message: Elastic search failed
  securitySchemes:
    bearerAuth:
      type: http
      scheme: bearer
      bearerFormat: API Key
    bearerTokenQuery:
      type: apiKey
      in: query
      name: bearer_token
      description: >-
        Alternative to the Authorization header. Prefer the Authorization header
        whenever possible.

````

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