> ## Documentation Index > Fetch the complete documentation index at: https://support.callin.io/llms.txt > Use this file to discover all available pages before exploring further. # Get conversation > Returns full details for a single conversation including the transcript, sentiment analysis, key moments, collected data, and call metadata. ## OpenAPI ````yaml /openapi.json get /public/v1/conversations/{conversationId} openapi: 3.0.3 info: title: Callin Public API version: 1.0.0 description: >- The Callin public API lets you programmatically build and manage AI voice agents, control their knowledge bases, and retrieve call logs and transcripts. All endpoints are versioned under /public/v1. servers: - url: https://api.callin.io/api description: API Endpoint security: [] tags: - name: Health description: Service availability check. No authentication required. - name: Identity description: Verify which account is associated with the current API key. - name: Agents description: Create, retrieve, and update AI voice agents. - name: Conversations description: List and inspect call logs, transcripts, and conversation details. - name: Knowledge Base description: Manage documents and groups that agents use during calls. paths: /public/v1/conversations/{conversationId}: get: tags: - Conversations summary: Get conversation description: >- Returns full details for a single conversation including the transcript, sentiment analysis, key moments, collected data, and call metadata. parameters: - name: conversationId in: path required: true schema: type: string description: The unique identifier of the conversation. responses: '200': description: Full conversation details. content: application/json: schema: $ref: '#/components/schemas/SuccessConversationDetailsResponse' '404': description: No conversation found with the given conversationId. content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' security: - ApiKeyHeader: [] - BearerAuth: [] - ApiKeyQuery: [] components: schemas: SuccessConversationDetailsResponse: type: object properties: success: type: boolean example: true data: $ref: '#/components/schemas/ConversationDetails' description: >- Deep conversation record: transcript, sentiment, collected data, and metadata. ErrorResponse: type: object description: >- Returned for most client and validation errors. Read `error.message` and optional `error.fields` for details. properties: success: type: boolean example: false description: Always `false` for this shape. error: type: object description: Structured error payload from the API. properties: code: type: string description: Stable machine-oriented error code when provided. message: type: string description: Human-readable explanation suitable to show or log. status: type: integer description: HTTP status code echoed for convenience. fields: type: array description: >- Optional per-field validation issues (shape is endpoint-specific). items: type: object ConversationDetails: type: object properties: agentId: type: string description: The ID of the agent agentName: type: string description: The name of the agent status: type: string description: The status of the conversation enum: - completed - in_progress - cancelled - failed - scheduled example: completed direction: type: string description: The direction of the conversation enum: - outbound - inbound example: outbound conversationDuration: type: number description: Duration of the call in seconds. startTimeUnix: type: integer nullable: true description: Call start time as a Unix timestamp in seconds. endTimeUnix: type: integer nullable: true description: Call end time as a Unix timestamp in seconds. summary: type: string description: AI-generated summary of the conversation. transcript: type: string description: Full text transcript of the call. contactNumber: type: string description: Phone number of the contact (the person called or calling in). callerNumber: type: string description: Phone number the call was placed from. sentiment: type: object description: AI-analysed sentiment for the conversation. properties: sentiment_score: type: number description: The sentiment score of the conversation sentiment_by_turn: type: array description: The sentiment by turn of the conversation items: type: object properties: text: type: string description: The text of the sentiment sentiment_score: type: number description: The sentiment score of the sentiment sentiment_label: type: string description: The sentiment label of the sentiment speaker: type: string description: The speaker of the sentiment sentiment_overall: type: string description: The overall sentiment of the conversation keyMoments: type: array description: >- Notable moments detected during the call such as objections or confirmations. items: type: object properties: text: type: string description: The text of the key moment label: type: string description: The label of the key moment speaker: type: string description: The speaker of the key moment timestamp: type: string description: The timestamp of the key moment appointmentScheduled: type: object additionalProperties: true description: Appointment details if the agent scheduled one during the call. dataCollected: type: object description: Structured data captured by the agent during the call. properties: entity: type: string description: The name of the extracted entity value: type: string description: The value of the extracted entity voiceMailDetected: type: boolean description: True if the call reached a voicemail instead of a live person. errorMessage: type: string description: Error description if the call failed or ended unexpectedly. callTransferred: type: boolean description: True if the call was transferred to a human agent. metadata: type: object properties: createdAt: type: string description: The date and time the conversation was created createdBy: $ref: '#/components/schemas/MetaCreatedBy' MetaCreatedBy: type: object properties: userId: type: string description: The ID of the user who created the item userEmail: type: string description: The email of the user who created the item securitySchemes: ApiKeyHeader: type: apiKey in: header name: x-api-key description: Send your Callin API key in the `x-api-key` header. BearerAuth: type: http scheme: bearer bearerFormat: API Key description: 'Same API key as a Bearer token: `Authorization: Bearer `.' ````