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

# Get Call

> Retrieve details of a specific call



## OpenAPI

````yaml GET /calls/{uuid}
openapi: 3.1.0
info:
  title: Public API v1
  description: >-
    Public API v1 requiring API keys.


    **Timestamps:** All datetime fields in API responses are returned in UTC
    using ISO 8601 format (e.g., `2024-01-15T14:30:00Z`). When filtering by date
    parameters, provide timestamps in ISO 8601 format.
  version: 0.1.0
servers:
  - url: https://api.prod.usesimple.ai/api/v1
    description: Production API Server
security: []
paths:
  /calls/{uuid}:
    get:
      tags:
        - Calls
      summary: Get Call Details
      description: |-
        Get details for a specific call.
        Only returns calls associated with the API key's account.
      operationId: get_call_details_calls__uuid__get
      parameters:
        - name: uuid
          in: path
          required: true
          schema:
            type: string
            format: uuid
            title: Uuid
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallDetailsResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
      security:
        - APIKeyHeader: []
components:
  schemas:
    CallDetailsResponse:
      properties:
        id:
          type: integer
          title: Id
        simple_uuid:
          type: string
          format: uuid
          title: Simple Uuid
        record:
          type: boolean
          title: Record
        language:
          $ref: '#/components/schemas/LanguageEnum'
        from_number:
          type: string
          title: From Number
        to_number:
          type: string
          title: To Number
        status:
          type: string
          title: Status
        transferred:
          type: boolean
          title: Transferred
          description: Indicates if the call was transferred
        handoff_metadata:
          anyOf:
            - $ref: '#/components/schemas/HandoffMetadata'
            - type: 'null'
          title: Handoff Metadata
          description: >-
            Metadata about the handoff when the call was transferred to an
            external provider (e.g. Five9). Null if the call was not
            transferred.
        direction:
          type: string
          title: Direction
          description: The direction of the call (inbound/outbound)
        tags:
          type: array
          title: Tags
          description: Tags associated with the call
          items:
            type: object
            properties:
              id:
                type: string
                format: uuid
              name:
                type: string
              description:
                type: string
              color:
                type: string
        voice_id:
          anyOf:
            - type: string
              format: uuid
            - type: 'null'
          title: Voice ID
          description: The ID of the voice used for the call
        background_noise:
          anyOf:
            - type: string
            - type: 'null'
          title: Background Noise
          description: The background noise setting for the call
        agent_speaks_first:
          anyOf:
            - type: boolean
            - type: 'null'
          title: Agent Speaks First
          description: Whether the agent speaks first in the call
        started_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Started At
        ended_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Ended At
        duration:
          anyOf:
            - type: integer
            - type: 'null'
          title: Duration
        created_at:
          type: string
          format: date-time
          title: Created At
        external_identifiers:
          anyOf:
            - type: object
              additionalProperties:
                type: string
            - type: 'null'
          title: External Identifiers
          description: External identifiers associated with the call
        params:
          anyOf:
            - type: object
              additionalProperties:
                type: string
            - type: 'null'
          title: Params
          description: Parameters associated with the call
        prompt:
          anyOf:
            - $ref: '#/components/schemas/CallPromptResponse'
            - type: 'null'
        transcripts:
          items:
            $ref: '#/components/schemas/CallTranscriptResponse'
          type: array
          title: Transcripts
        recording_presigned_url:
          anyOf:
            - type: string
            - type: 'null'
          title: Recording Presigned Url
        call_prompt:
          type: string
          title: Call Prompt
        answered_by:
          $ref: '#/components/schemas/AnsweredByEnum'
        analyzers:
          type: array
          title: Analyzers
          description: List of analyzers configured for this call
          items:
            $ref: '#/components/schemas/AnalyzerResponse'
        analysis_results:
          type: array
          title: Analysis Results
          description: Results from analyzers that have completed
          items:
            $ref: '#/components/schemas/AnalysisResultResponse'
        summary:
          anyOf:
            - type: object
            - type: 'null'
          title: Summary
          description: The summary of the call if available
      type: object
      required:
        - id
        - simple_uuid
        - from_number
        - to_number
        - status
        - started_at
        - ended_at
        - duration
        - created_at
        - prompt
        - transcripts
        - call_prompt
        - answered_by
      title: CallDetailsResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    LanguageEnum:
      type: string
      enum:
        - en
        - es
        - ar
      title: Language
      description: The language to use for the call - English (en) or Spanish (es)
    HandoffMetadata:
      type: object
      title: HandoffMetadata
      description: Metadata about a transfer to an external provider.
      properties:
        five9:
          anyOf:
            - $ref: '#/components/schemas/Five9HandoffMetadata'
            - type: 'null'
          title: Five9
          description: Five9 handoff details. Present when the transfer was to Five9.
    CallPromptResponse:
      properties:
        prompt_text:
          type: string
          title: Prompt Text
        created_at:
          type: string
          format: date-time
          title: Created At
      type: object
      required:
        - prompt_text
        - created_at
      title: CallPromptResponse
    CallTranscriptResponse:
      properties:
        text:
          anyOf:
            - type: string
            - type: 'null'
          title: Text
        role:
          type: string
          title: Role
        timestamp:
          type: string
          format: date-time
          title: Timestamp
        function_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Function Name
        arguments:
          anyOf:
            - type: object
            - type: 'null'
          title: Arguments
      type: object
      required:
        - text
        - role
        - timestamp
        - function_name
        - arguments
      title: CallTranscriptResponse
    AnsweredByEnum:
      type: string
      enum:
        - voicemail
        - human
        - no_answer
        - unknown
      title: Answered By
      description: >-
        Indicates how the call was answered - by a human, voicemail, or if there
        was no answer
    AnalyzerResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Unique identifier for the analyzer
        prompt:
          type: string
          title: Prompt
          description: The prompt used for analysis
        output_config:
          type: object
          title: Output Config
          description: Configuration for the expected output format
          properties:
            type:
              type: string
              enum:
                - string
                - boolean
                - datetime
                - object
              description: The type of output expected
            properties:
              type: object
              description: >-
                Required when type is 'object'. Defines the structure of the
                object
              additionalProperties:
                type: object
                properties:
                  type:
                    type: string
                    enum:
                      - string
                      - boolean
                      - datetime
      required:
        - id
        - prompt
        - output_config
      title: AnalyzerResponse
    AnalysisResultResponse:
      type: object
      properties:
        id:
          type: string
          format: uuid
          title: Id
          description: Unique identifier for the analysis result
        analyzer_id:
          type: string
          format: uuid
          title: Analyzer Id
          description: Identifier of the analyzer that produced this result
        prompt:
          type: string
          title: Prompt
          description: The prompt used for analysis
        output_config:
          type: object
          title: Output Config
          description: Configuration for the expected output format
        result:
          type: object
          title: Result
          description: The analysis result, structure depends on the output_config
      required:
        - id
        - analyzer_id
        - prompt
        - output_config
        - result
      title: AnalysisResultResponse
    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
    Five9HandoffMetadata:
      type: object
      title: Five9HandoffMetadata
      description: Details of a transfer to Five9.
      properties:
        conversation_id:
          type: string
          title: Conversation ID
          description: The Five9 conversation ID. Use this to correlate with Five9's API.
        tenant_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Tenant Name
          description: The Five9 tenant name used for the transfer.
        campaign_name:
          anyOf:
            - type: string
            - type: 'null'
          title: Campaign Name
          description: The Five9 campaign the conversation was routed to.
        transferred_at:
          anyOf:
            - type: string
              format: date-time
            - type: 'null'
          title: Transferred At
          description: When the transfer occurred (ISO 8601).
  securitySchemes:
    APIKeyHeader:
      type: apiKey
      in: header
      name: Authorization

````