> ## Documentation Index > Fetch the complete documentation index at: https://voice.ai/llms.txt > Use this file to discover all available pages before exploring further. # Call History > Retrieve detailed call logs. ## OpenAPI ````yaml /docs/openapi.json get /api/v1/agent/call-history openapi: 3.1.0 info: title: Voice AI Developer API description: >- Generate realistic speech and clone voices. AI voice agents with retrieval augmented generation (RAG) and model context protocol (MCP) included. version: 1.5.0 contact: {} servers: - url: https://dev.voice.ai description: HTTP API endpoints security: - BearerAuth: [] tags: - name: Text To Speech description: Text-to-speech endpoints for voice cloning and speech generation. - name: Pronunciation Dictionaries description: Manage versioned pronunciation dictionaries for TTS and voice agents. - name: Agent Management description: Create, update, deploy, and manage voice agents. - name: Models description: Discover supported LLM and TTS model options. - name: Agent Connection description: Connect to agents and manage active calls. - name: Agent Analytics description: >- Analytics and reporting for agent performance, call history, and statistics. - name: Agent Knowledge Base description: >- Manage knowledge bases for retrieval augmented generation (RAG) with your agents. - name: Phone Number Management description: >- Search, select, and manage phone numbers from your plan allocation. Release numbers to free up slots. - name: Managed Tools description: >- Connect Google Calendar, Sheets, and Gmail to agents and inspect connection state. paths: /api/v1/agent/call-history: get: tags: - Agent Analytics summary: Call History description: Retrieve detailed call logs. operationId: get_call_history_api_v1_agent_call_history_get parameters: - name: page in: query required: false schema: type: integer minimum: 1 default: 1 title: Page - name: limit in: query required: false schema: type: integer maximum: 100 minimum: 1 default: 10 title: Limit - name: start_date in: query required: false schema: type: string description: >- Filter calls after this date (ISO format UTC, e.g., 2024-01-01T00:00:00+00:00) title: Start Date - name: end_date in: query required: false schema: type: string description: >- Filter calls before this date (ISO format UTC, e.g., 2024-12-31T23:59:59+00:00) title: End Date - name: agent_ids in: query required: false schema: items: type: string type: array description: >- Filter calls by agent ID(s). Can provide multiple agent IDs as a list. title: Agent Ids description: >- Filter calls by agent ID(s). Can provide multiple agent IDs as a list (e.g., ?agent_ids=agent1&agent_ids=agent2). style: form explode: true responses: '200': description: >- Successful Response - Returns paginated call history items, including the stable call_id for each call. content: application/json: schema: $ref: '#/components/schemas/PaginatedCallHistoryResponse' example: items: - id: 123 call_id: call_01JABCDEF23456789XYZ agent_id: agent_123 agent_name: Support Agent call_timestamp: '2026-03-01T18:42:11Z' call_duration_seconds: 184.5 credits_used: 3.69 has_transcript: true call_type: web from_number: null to_number: null transcription_summary: Customer asked about account access and password reset. transcription_stats: duration_seconds: 184.5 speaker_turns: 14 pagination: page: 1 limit: 10 total: 1 total_pages: 1 '401': description: Unauthorized - Invalid or missing API key content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' '422': description: Validation Error content: application/json: schema: $ref: '#/components/schemas/HTTPValidationError' '500': description: Internal Server Error content: application/json: schema: $ref: '#/components/schemas/ErrorResponse' components: schemas: PaginatedCallHistoryResponse: properties: items: items: $ref: '#/components/schemas/CallHistoryItem' type: array title: Items pagination: $ref: '#/components/schemas/PaginationMeta' type: object required: - items - pagination title: PaginatedCallHistoryResponse ErrorResponse: properties: error: type: string title: Error description: Error message detail: type: string title: Detail description: Detailed error information nullable: true code: type: string title: Code description: Error code nullable: true type: object required: - error title: ErrorResponse HTTPValidationError: properties: detail: items: $ref: '#/components/schemas/ValidationError' type: array title: Detail type: object title: HTTPValidationError CallHistoryItem: properties: id: type: integer title: Id call_id: type: string title: Call Id agent_id: type: string title: Agent Id nullable: true agent_name: type: string title: Agent Name nullable: true call_timestamp: type: string format: date-time title: Call Timestamp call_duration_seconds: type: number title: Call Duration Seconds credits_used: type: number title: Credits Used has_transcript: type: boolean title: Has Transcript call_type: type: string title: Call Type nullable: true from_number: type: string title: From Number nullable: true to_number: type: string title: To Number nullable: true transcription_summary: type: string title: Transcription Summary nullable: true transcription_stats: anyOf: - additionalProperties: true type: object - type: 'null' title: Transcription Stats nullable: true type: object required: - id - call_id - call_timestamp - call_duration_seconds - credits_used - has_transcript title: CallHistoryItem PaginationMeta: properties: current_page: type: integer title: Current Page total_pages: type: integer title: Total Pages total_items: type: integer title: Total Items limit: type: integer title: Limit has_next: type: boolean title: Has Next has_previous: type: boolean title: Has Previous type: object required: - current_page - total_pages - total_items - limit - has_next - has_previous title: PaginationMeta ValidationError: properties: loc: items: anyOf: - type: string - type: integer type: array title: Location msg: type: string title: Message type: type: string title: Error Type type: object required: - loc - msg - type title: ValidationError securitySchemes: BearerAuth: type: http scheme: bearer bearerFormat: JWT description: >- Bearer token authentication. Use your API key as the bearer token. Format: Authorization: Bearer ````