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

# Get a call

> One call, with its transcript.



## OpenAPI

````yaml /api-reference/openapi.json get /voice-agents/calls/{callId}
openapi: 3.1.0
info:
  title: Talking Avatar API
  version: '1'
  description: >-
    Your account from your server, with an API key: voice agents, calls,
    knowledge bases, links, usage and billing. Send API-Version: 1 to pin
    version 1.
servers:
  - url: https://backend.talking-avatar.dev/api/talking-avatar
security:
  - apiKey: []
paths:
  /voice-agents/calls/{callId}:
    get:
      summary: Get a call
      description: One call, with its transcript.
      parameters:
        - name: callId
          in: path
          required: true
          description: The call's ID
          schema:
            type: string
            format: uuid
        - name: API-Version
          in: header
          description: 'The API version. Without it: 1.'
          schema:
            type: string
            enum:
              - '1'
      responses:
        '200':
          description: Success
          content:
            application/json:
              schema:
                type: object
                properties:
                  data:
                    type: object
                    properties:
                      id:
                        type: string
                        format: uuid
                        description: >-
                          The call's ID, as in its tool calls and post-call
                          webhook
                      voice_agent_id:
                        type:
                          - string
                          - 'null'
                        format: uuid
                        description: Its agent; null once the agent is deleted
                      agent_name:
                        type: string
                        description: The agent's name at the time
                      avatar:
                        type:
                          - string
                          - 'null'
                      voice:
                        type:
                          - string
                          - 'null'
                      source:
                        type:
                          - string
                          - 'null'
                        enum:
                          - link
                          - embed
                          - test
                          - null
                        description: >-
                          Where it started: link (the share link), embed, or
                          test (a dashboard test call)
                      status:
                        type: string
                        enum:
                          - active
                          - completed
                          - failed
                        description: >-
                          active while it runs; completed; failed: it never went
                          live
                      created_at:
                        type: string
                        format: date-time
                      started_at:
                        type:
                          - string
                          - 'null'
                        format: date-time
                        description: When it went live
                      ended_at:
                        type:
                          - string
                          - 'null'
                        format: date-time
                      duration_seconds:
                        type:
                          - number
                          - 'null'
                      ended_reason:
                        type:
                          - string
                          - 'null'
                        description: Why it ended
                      replies:
                        type: integer
                        description: How many times the agent replied
                      interruptions:
                        type: integer
                        description: How many times the caller interrupted
                      tool_calls:
                        type: integer
                        description: How many tool calls it made
                      webhook_status:
                        type:
                          - integer
                          - 'null'
                        description: Your post-call webhook's HTTP status; null without one
                      cost_usd:
                        type:
                          - number
                          - 'null'
                        description: What it cost; null until it is billed
                      transcript:
                        type: array
                        maxItems: 5000
                        items:
                          type: object
                          properties:
                            role:
                              type: string
                              enum:
                                - user
                                - agent
                            text:
                              type: string
                              maxLength: 20000
                          required:
                            - role
                            - text
                          additionalProperties: false
                    required:
                      - id
                      - voice_agent_id
                      - agent_name
                      - avatar
                      - voice
                      - source
                      - status
                      - created_at
                      - started_at
                      - ended_at
                      - duration_seconds
                      - ended_reason
                      - replies
                      - interruptions
                      - tool_calls
                      - webhook_status
                      - cost_usd
                      - transcript
                    additionalProperties: false
                  code:
                    type: integer
                    const: 200
                  message:
                    type: string
                required:
                  - data
                  - code
        4XX:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        5XX:
          description: Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      x-codeSamples:
        - lang: bash
          label: cURL
          source: >-
            curl
            https://backend.talking-avatar.dev/api/talking-avatar/voice-agents/calls/CALL_ID
            \
              -H "Authorization: Bearer $TALKING_AVATAR_API_KEY" \
              -H "API-Version: 1"
        - lang: python
          label: Python
          source: |-
            import os, requests

            response = requests.get(
                "https://backend.talking-avatar.dev/api/talking-avatar/voice-agents/calls/CALL_ID",
                headers={
                    "Authorization": f"Bearer {os.environ['TALKING_AVATAR_API_KEY']}",
                    "API-Version": "1",
                },
            )
            response.raise_for_status()
            data = response.json()["data"]
        - lang: javascript
          label: Node.js
          source: >-
            const response = await
            fetch("https://backend.talking-avatar.dev/api/talking-avatar/voice-agents/calls/CALL_ID",
            {
              method: "GET",
              headers: {
                Authorization: `Bearer ${process.env.TALKING_AVATAR_API_KEY}`,
                "API-Version": "1",
              },
            });

            const { data } = await response.json();
components:
  schemas:
    Error:
      type: object
      properties:
        code:
          type: integer
          description: The HTTP status
        message:
          type: string
          description: What went wrong, readable
        data:
          type: 'null'
      required:
        - code
      additionalProperties: false
  securitySchemes:
    apiKey:
      type: http
      scheme: bearer
      description: Your API key, tav_…
      x-default: YOUR_API_KEY

````

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