> ## 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.

# Get Call

> Retrieve details for a single call by its unique identifier.



## OpenAPI

````yaml GET /v1/calls/{id}
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/{id}:
    get:
      tags:
        - calls
      summary: Get call by id
      description: >-
        Returns call detail for a single call record, including transcript
        entries and recording URL when available.
      operationId: getCall
      parameters:
        - schema:
            type: string
            description: Call id.
            example: ce7e2g8z4qbydxtjq8rbxprc4x7f2h5d
          required: true
          name: id
          in: path
        - schema:
            type: string
            description: >-
              Optional workspace override. If omitted, Conduit resolves the
              call's workspace automatically.
            example: j57demo8f8x7c9v0n2q4r6t8y1u3i5o
          required: false
          name: workspace_id
          in: query
      responses:
        '200':
          description: Call
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    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
                      transcript:
                        type: array
                        items:
                          type: object
                          properties:
                            author:
                              type: string
                            text:
                              type: string
                            start:
                              type: number
                              nullable: true
                            end:
                              type: number
                              nullable: true
                          required:
                            - author
                            - text
                            - start
                            - end
                    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
                      - transcript
                required:
                  - data
                description: >-
                  Call detail response including transcript and recording URL
                  when available.
                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
                    transcript:
                      - author: guest
                        text: Hi, can I check in early?
                        start: 0.2
                        end: 2.8
                      - author: agent
                        text: Let me confirm that for you.
                        start: 3
                        end: 5.4
        '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
        '404':
          description: Not found
          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 <token>`. Read/write
        endpoints require a token with write access.

````