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

# Get Call

> Return one call belonging to an accessible agent.

Returns call details and analysis for the supplied call and agent IDs. The API key must belong to the supplied user, and that user must have access to the agent.

Phonely returns `404` when the call does not exist or does not belong to the specified agent.


## OpenAPI

````yaml POST /get-call
openapi: 3.0.1
info:
  title: Phonely API
  description: API for Phonely services including agent management and call summaries
  version: 1.0.0
servers:
  - url: https://app.phonely.ai/api
security: []
paths:
  /get-call:
    post:
      summary: Get call information
      description: Retrieve information for a specific call
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/GetCallRequest'
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallSummaryResponse'
        '400':
          description: Invalid request
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '404':
          description: Call or agent not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/Error'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    GetCallRequest:
      type: object
      required:
        - uid
        - agentId
        - callId
      properties:
        uid:
          type: string
          description: User ID (can be retrieved from the user settings page)
        agentId:
          type: string
          description: Agent ID (can be retrieved from the agent settings page)
        callId:
          type: string
          description: Call ID (can be retrieved from the call history page)
    CallSummaryResponse:
      type: object
      required:
        - agentName
        - transcriptText
        - dashboardUrl
      properties:
        agentName:
          type: string
          description: Name of the agent handling the call
        callId:
          type: string
          description: Unique identifier for the call
        agentId:
          type: string
          description: ID of the agent that handled the call
        businessPhoneNumber:
          type: string
          nullable: true
          description: Business phone number used for the call
        customerPhoneNumber:
          type: string
          nullable: true
          description: Customer phone number
        transcript:
          type: array
          items:
            $ref: '#/components/schemas/TranscriptEntry'
          nullable: true
          description: Structured call messages
        messages:
          type: array
          items:
            $ref: '#/components/schemas/TranscriptEntry'
          nullable: true
          description: Structured call messages; currently the same data as transcript
        summary:
          type: string
          nullable: true
          description: Brief summary of the call
        longSummary:
          type: string
          nullable: true
          description: Detailed summary of the call
        ai_success:
          type: boolean
          nullable: true
          description: Whether the AI completed the call successfully
        sentiment:
          type: string
          nullable: true
          description: Overall sentiment of the call
        topic:
          oneOf:
            - type: string
              nullable: true
            - type: array
              items:
                type: string
          description: Topic or topic labels assigned to the call
        purpose:
          type: string
          nullable: true
          description: Main purpose of the call
        keyPoints:
          type: array
          items:
            type: string
          nullable: true
          description: Key points identified during the call
        mentionedDate:
          type: string
          nullable: true
          description: Date mentioned during the call
        mentionedTime:
          type: string
          nullable: true
          description: Time mentioned during the call
        mentionedEmail:
          type: string
          nullable: true
          description: Email address mentioned during the call
        callerName:
          type: string
          nullable: true
          description: Caller name extracted from the call
        unansweredQuestions:
          type: array
          items:
            type: string
          nullable: true
          description: List of questions that were not answered during the call
        actionItems:
          type: array
          items:
            type: string
          nullable: true
          description: List of action items identified during the call
        followUpReason:
          type: string
          nullable: true
          description: Reason for any required follow-up
        followUp:
          type: boolean
          nullable: true
          description: Whether follow-up is required
        callDirection:
          type: string
          nullable: true
          description: Call type or direction
        recordingUrl:
          type: string
          nullable: true
          description: URL to access the call recording
        transcriptText:
          type: string
          description: Text transcript containing user and assistant messages
        callStarted:
          $ref: '#/components/schemas/FirestoreTimestamp'
        startedAt:
          $ref: '#/components/schemas/FirestoreTimestamp'
        callEnded:
          $ref: '#/components/schemas/FirestoreTimestamp'
        callStartedDateString:
          type: string
          description: Call start formatted in the agent's timezone
        callEndedDateString:
          type: string
          description: Call end formatted in the agent's timezone
        duration:
          type: number
          description: Duration of the call in seconds
        endedReason:
          type: string
          nullable: true
          description: Reason for the call ending
        dashboardUrl:
          type: string
          format: uri
          description: URL to open the call in Phonely
    Error:
      type: object
      properties:
        error:
          type: string
          description: Error code or identifier
        message:
          type: string
          description: Detailed error message
    TranscriptEntry:
      type: object
      required:
        - content
        - role
      properties:
        content:
          oneOf:
            - type: string
            - type: object
              additionalProperties: true
          description: Content of the transcript entry
        role:
          type: string
          enum:
            - user
            - assistant
            - interruption
            - action
            - workflow_triggered
            - kb_retrieval
            - state_transition
            - control
            - stored_variables
            - tts_failover
            - endpointing_result
            - response_type
          description: Message role
        timestamp:
          type: number
        isPositive:
          type: boolean
        requestId:
          type: string
        response_issue_tags:
          type: array
          items:
            type: string
        user_instructions:
          type: string
    FirestoreTimestamp:
      type: object
      required:
        - _seconds
        - _nanoseconds
      properties:
        _seconds:
          type: integer
          format: int64
        _nanoseconds:
          type: integer
      description: Serialized Firestore timestamp
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: X-Authorization

````

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