> ## Documentation Index > Fetch the complete documentation index at: https://docs.conduit.ai/llms.txt > Use this file to discover all available pages before exploring further. # List Calls > Retrieve a paginated list of all calls in your workspace. ## OpenAPI ````yaml GET /v1/calls openapi: 3.0.0 info: title: Conduit API version: 1.0.0 description: Public API for Conduit. servers: - url: https://api.conduit.ai description: Production security: [] tags: - name: meta description: Discovery and API metadata endpoints. - name: agents description: >- V2 chat agent configuration, including instructions, skills, triggers, and automation behavior. - name: contacts description: >- Contact profile and contact-scoped related resources such as tickets and calls. - name: workspaces description: Workspaces accessible to the current API token. - name: escalations description: >- Chat escalations that require operator review, including message, proposed response, and disposition context when available. - name: conversations description: >- Canonical message threads. Use these endpoints to list threads, inspect conversation state, read transcripts, and send replies. - name: conversation-tags description: >- Conversation labels, root topics, and subtopics used for classification and topic analytics. - name: tickets description: >- Operational queue items tied to conversations, including ticket-scoped transcripts and replies. - name: calls description: Phone call records, transcripts, summaries, and recordings when available. - name: reservations description: >- PMS reservations synced from the workspace's integrations (Hostaway, Guesty, Airbnb, etc.), including guest identity, payment status, and stay dates. - name: appointments description: >- Scheduled appointments (bookings) backed by the Conduit booking service. Exposes allocation context and the upstream booking-service `external_id`. - name: helpdesk_tickets description: >- Helpdesk tickets mirrored from external helpdesk integrations (Zendesk, Pylon, Plain), including requester identity and upstream metadata. - name: kb description: >- Knowledge base search and node management. Nodes represent knowledge base entries (files or directories), chunks are the indexed retrieval units used by search. - name: skills description: >- Workspace agent skills that can be attached to V2 chat agents. Sidebar/global-assistant skills are intentionally excluded. - name: custom_tools description: >- Custom code tools: user-authored Python/JavaScript functions executed in a sandbox when an agent calls them. Includes a runtimes endpoint describing the entrypoint signature, return shape, and available dependencies per language. - name: inbox_types description: >- Workspace inbox types. Each id is stable and usable as a message trigger's `inboxTypeId` and as the `inbox_type_id` filter on list conversations. paths: /v1/calls: get: tags: - calls summary: List calls description: >- Returns paginated call records for a workspace. Filter by direction, missed status, source, or phone number to narrow the result set. operationId: listCalls parameters: - schema: type: string description: Workspace to query. example: j57demo8f8x7c9v0n2q4r6t8y1u3i5o required: true name: workspace_id in: query - schema: type: integer minimum: 1 maximum: 100 required: false name: limit in: query - schema: type: string required: false name: cursor in: query - schema: type: string enum: - asc - desc required: false name: order in: query - schema: type: string enum: - inbound - outbound required: false name: direction in: query - schema: type: string enum: - 'true' - 'false' required: false name: missed in: query - schema: type: string enum: - app - retell required: false name: source in: query - schema: type: string required: false name: phone_number in: query responses: '200': description: Calls content: application/json: schema: type: object properties: data: type: array items: type: object properties: id: type: string workspace_id: type: string contact_id: type: string nullable: true conversation_id: type: string nullable: true ticket_id: type: string nullable: true call_id: type: string direction: type: string enum: - inbound - outbound from_phone: type: string to_phone: type: string nullable: true source: type: string nullable: true is_missed: type: boolean nullable: true transfer_status: type: string nullable: true duration_ms: type: number nullable: true sentiment: type: string nullable: true summary: type: string nullable: true recording_url: type: string nullable: true started_at: type: string created_at: type: string call_status: type: object nullable: true properties: success: type: boolean is_voicemail_reached: type: boolean nullable: true is_transferred: type: boolean nullable: true required: - success - is_voicemail_reached - is_transferred required: - id - workspace_id - contact_id - conversation_id - ticket_id - call_id - direction - from_phone - to_phone - source - is_missed - transfer_status - duration_ms - sentiment - summary - recording_url - started_at - created_at - call_status next_cursor: type: string nullable: true has_more: type: boolean required: - data - next_cursor - has_more description: Cursor-paginated calls response. example: data: - id: ce7e2g8z4qbydxtjq8rbxprc4x7f2h5d workspace_id: j57demo8f8x7c9v0n2q4r6t8y1u3i5o contact_id: ph77c0dy0mgdpzmqz6tesry8w184002s conversation_id: ph77c0dy0mgdpzmqz6tesry8w184002s ticket_id: xd88mkfbmxgckpeyzs8m9r9d3d843me3 call_id: call_123 direction: inbound from_phone: '+14155550123' to_phone: '+14155550999' source: retell is_missed: false transfer_status: null duration_ms: 183000 sentiment: neutral summary: Guest asked about check-in timing. recording_url: https://recordings.conduit.ai/calls/call_123.mp3 started_at: '2026-04-03T02:58:00.000Z' created_at: '2026-04-03T03:01:03.000Z' call_status: success: true is_voicemail_reached: false is_transferred: false next_cursor: page-token has_more: true '400': description: Invalid request content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id '401': description: Unauthorized content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id '403': description: Forbidden content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id '429': description: Rate limit exceeded content: application/json: schema: type: object properties: error: type: string required: - error description: Standard error response. example: error: Invalid workspace id security: - bearerAuth: [] components: securitySchemes: bearerAuth: type: http scheme: bearer bearerFormat: API Token description: >- Conduit API token. Use `Authorization: Bearer `. Read/write endpoints require a token with write access. ````