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

# Get a summary for a call

> Retrieve a detailed summary of a specific call identified by its unique call ID. This endpoint supports summaries for both regular calls and calls handled by Sona. Call summaries are only available on business and scale plans.



## OpenAPI

````yaml https://openphone-public-api-dev.s3.us-west-2.amazonaws.com/public/openphone-public-api-v1-dev.json get /v1/call-summaries/{callId}
openapi: 3.1.0
info:
  title: Quo Public API
  version: 1.0.0
  description: API for connecting with Quo.
  contact:
    name: Quo Support
    email: support@quo.com
    url: https://support.quo.com/
  termsOfService: https://www.quo.com/terms
servers:
  - description: Development server
    url: https://dev-public-api.openphone.dev
security:
  - apiKey: []
tags:
  - description: Operations related to the organization's A2P registration
    name: A2P Registration
  - description: Operations related to calls placed by an AI agent
    name: Agent Calls
  - description: Operations related to text conversations held by an AI agent
    name: Agent Conversations
  - description: Operations related to calls
    name: Calls
  - description: >-
      Operations related to call summaries, including AI-generated summaries and
      Sona voice assistant summaries
    name: Call Summaries
  - description: >-
      Operations related to call transcripts, including AI-generated transcripts
      and Sona voice assistant transcripts
    name: Call Transcripts
  - description: Operations related to contacts
    name: Contacts
  - description: Operations related to contact shares
    name: Contact Shares
  - description: Operations related to contact notes
    name: Contact Notes
  - description: Operations related to contact properties
    name: Contact Properties
  - description: Operations related to conversations
    name: Conversations
  - description: Operations related to workspace invitations
    name: Invites
  - description: Operations related to text messages
    name: Messages
  - description: Operations related to the organization
    name: Organization
  - description: Operations related to phone numbers
    name: Phone Numbers
  - description: Operations related to users
    name: Users
  - description: Operations related to webhooks
    name: Webhooks
  - description: >-
      Operations related to webhook events, including delivery history and test
      events
    name: Webhook Events
paths:
  /v1/call-summaries/{callId}:
    get:
      tags:
        - Calls
      summary: Get a summary for a call
      description: >-
        Retrieve a detailed summary of a specific call identified by its unique
        call ID. This endpoint supports summaries for both regular calls and
        calls handled by Sona. Call summaries are only available on business and
        scale plans.
      operationId: getCallSummary_v1
      parameters:
        - in: path
          name: callId
          required: true
          schema:
            description: The unique identifier of the call associated with the summary.
            examples:
              - AC3700e624eca547eb9f749a06f
            type: string
            pattern: ^AC(.*)$
          example: AC3700e624eca547eb9f749a06f
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                type: object
                required:
                  - data
                properties:
                  data:
                    type: object
                    required:
                      - callId
                      - nextSteps
                      - status
                      - summary
                    properties:
                      callId:
                        type: string
                        description: >-
                          The unique identifier of the call to which this
                          summary belongs.
                        examples:
                          - ACea724hac8c30465bcbcff0b76e4c1c7b
                        example: ACea724hac8c30465bcbcff0b76e4c1c7b
                      nextSteps:
                        anyOf:
                          - type: array
                            items:
                              type: string
                              examples:
                                - Bring an umbrella.
                              example: Bring an umbrella.
                            description: >-
                              An array of suggested next actions or follow-up
                              items derived from the call content. Null if no
                              next steps were identified or if no call summary
                              is available.
                          - type: 'null'
                      status:
                        type: string
                        enum:
                          - absent
                          - in-progress
                          - completed
                          - failed
                        description: The status of the call summary.
                        examples:
                          - completed
                        example: completed
                      summary:
                        anyOf:
                          - type: array
                            items:
                              type: string
                              examples:
                                - You talked about the weather.
                              example: You talked about the weather.
                            description: >-
                              An array of statements that encapsulate the key
                              points or main topics discussed during the call.
                              For Sona-generated summaries, this includes
                              structured Q&A pairs. Null if the summary is not
                              yet generated or if no call summary is available.
                          - type: 'null'
                      jobs:
                        anyOf:
                          - description: >-
                              Structured job results from Sona, Quo's AI voice
                              assistant. Contains Q&A pairs, task completions,
                              and other job-specific data collected during the
                              call. Only present for calls handled by Sona.
                            type: array
                            items:
                              type: object
                              required:
                                - icon
                                - name
                                - result
                              properties:
                                icon:
                                  type: string
                                name:
                                  type: string
                                result:
                                  type: object
                                  required:
                                    - data
                                  properties:
                                    data:
                                      type: array
                                      items:
                                        type: object
                                        required:
                                          - name
                                          - value
                                        properties:
                                          name:
                                            type: string
                                          value:
                                            anyOf:
                                              - type: string
                                              - type: number
                                              - type: boolean
                          - type: 'null'
        '400':
          description: Bad Request
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    type: string
                    const: '0500400'
                  status:
                    type: number
                    const: 400
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Bad Request
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                anyOf:
                  - type: object
                    required:
                      - error
                    properties:
                      error:
                        type: object
                        required:
                          - message
                          - key
                        properties:
                          message:
                            type: string
                          key:
                            type: string
                            const: Unauthorized
                          trace:
                            type: string
                  - type: object
                    required:
                      - message
                      - code
                      - status
                      - docs
                      - title
                    properties:
                      message:
                        type: string
                      code:
                        type: string
                        const: '0500401'
                      status:
                        type: number
                        const: 401
                      docs:
                        type: string
                        const: https://quo.com/docs
                      title:
                        type: string
                        const: Unauthorized
                      trace:
                        type: string
                      errors:
                        type: array
                        items:
                          type: object
                          required:
                            - path
                            - message
                            - schema
                          properties:
                            path:
                              type: string
                            message:
                              type: string
                            value: {}
                            schema:
                              type: object
                              required:
                                - type
                              properties:
                                type:
                                  type: string
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    type: string
                    const: '0500403'
                  status:
                    type: number
                    const: 403
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Forbidden
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
        '404':
          description: Not Found
          content:
            application/json:
              schema:
                type: object
                required:
                  - message
                  - code
                  - status
                  - docs
                  - title
                properties:
                  message:
                    type: string
                  code:
                    type: string
                    const: '0500404'
                  status:
                    type: number
                    const: 404
                  docs:
                    type: string
                    const: https://quo.com/docs
                  title:
                    type: string
                    const: Not Found
                  trace:
                    type: string
                  errors:
                    type: array
                    items:
                      type: object
                      required:
                        - path
                        - message
                        - schema
                      properties:
                        path:
                          type: string
                        message:
                          type: string
                        value: {}
                        schema:
                          type: object
                          required:
                            - type
                          properties:
                            type:
                              type: string
        '500':
          description: Unexpected Error | Unknown Error
          content:
            application/json:
              schema:
                oneOf:
                  - $ref: '#/components/schemas/UnexpectedError3'
                  - $ref: '#/components/schemas/UnknownError3'
      security:
        - apiKey: []
components:
  schemas:
    UnexpectedError3:
      type: object
      required:
        - message
        - code
        - status
        - docs
        - title
      properties:
        message:
          type: string
        code:
          type: string
          const: '0500500'
        status:
          type: number
          const: 500
        docs:
          type: string
          const: https://quo.com/docs
        title:
          type: string
          const: Unexpected
        trace:
          type: string
        errors:
          type: array
          items:
            type: object
            required:
              - path
              - message
              - schema
            properties:
              path:
                type: string
              message:
                type: string
              value: {}
              schema:
                type: object
                required:
                  - type
                properties:
                  type:
                    type: string
      title: Unexpected Error
    UnknownError3:
      type: object
      required:
        - message
        - code
        - status
        - docs
        - title
      properties:
        message:
          type: string
        code:
          type: string
          const: '0501500'
        status:
          type: number
          const: 500
        docs:
          type: string
          const: https://quo.com/docs
        title:
          type: string
          const: Unknown
        trace:
          type: string
        errors:
          type: array
          items:
            type: object
            required:
              - path
              - message
              - schema
            properties:
              path:
                type: string
              message:
                type: string
              value: {}
              schema:
                type: object
                required:
                  - type
                properties:
                  type:
                    type: string
      title: Unknown Error
  securitySchemes:
    apiKey:
      in: header
      name: Authorization
      type: apiKey

````