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

# Get call logs and analysis

> Returns detailed call logs, including transcripts, recordings, and AI generated analysis.



## OpenAPI

````yaml /api-reference/openapi.json post /call-logs/{assistant_id}
openapi: 3.1.0
info:
  title: SuperU API
  description: >-
    Comprehensive API reference for SuperU voice agents, calls, tools, contacts,
    audiences, and knowledge bases.
  version: 1.0.0
servers:
  - url: https://voip-middlware.superu.ai
    description: Production
security:
  - superUApiKey: []
tags:
  - name: Calls
    description: Create and analyze calls.
  - name: Agents
    description: Create, list, import, update, and delete agents.
  - name: Agent Versions
    description: Manage versions for existing agents.
  - name: Phone Numbers
    description: Fetch phone numbers available in your account.
  - name: Call Logs
    description: Retrieve call history with filters.
  - name: Tools
    description: Create and manage callable tools.
  - name: Folders
    description: Organize agents into folders.
  - name: Contacts
    description: Create and list contacts.
  - name: Audiences
    description: Create and manage audiences and contacts.
  - name: Knowledge Base
    description: Upload and manage knowledge bases.
  - name: Campaigns
    description: Create and manage outbound campaigns with automated workflows.
paths:
  /call-logs/{assistant_id}:
    post:
      tags:
        - Call Logs
      summary: Get call logs and analysis
      description: >-
        Returns detailed call logs, including transcripts, recordings, and AI
        generated analysis.
      operationId: getCallLogs
      parameters:
        - name: assistant_id
          in: path
          description: Assistant ID or `all`
          required: true
          schema:
            type: string
            example: all
        - name: limit
          in: query
          description: Records per page
          required: false
          schema:
            type: integer
            minimum: 1
            maximum: 100
            default: 20
            example: 20
        - name: page
          in: query
          description: Page number
          required: false
          schema:
            type: integer
            minimum: 1
            default: 1
            example: 1
        - name: before
          in: query
          description: Upper timestamp/date bound
          required: false
          schema:
            type: string
            example: '2026-02-01T00:00:00Z'
        - name: after
          in: query
          description: Lower timestamp/date bound
          required: false
          schema:
            type: string
            example: '2026-01-01T00:00:00Z'
        - name: status
          in: query
          description: Call status filter
          required: false
          schema:
            type: string
            example: completed
        - name: campaign_id
          in: query
          description: Campaign filter
          required: false
          schema:
            type: string
            example: demo_call
        - name: search_query
          in: query
          description: Search filter
          required: false
          schema:
            type: string
            example: Ava
      responses:
        '200':
          description: Call logs returned
          content:
            application/json:
              schema:
                type: object
                properties:
                  success:
                    type: boolean
                  data:
                    type: object
                    description: >-
                      <details>

                      <summary>Hangup Causes</summary>


                      <table>

                      <thead>

                      <tr><th>Cause</th><th>Description</th></tr>

                      </thead>

                      <tbody>

                      <tr><td colspan="2"><strong>Normal
                      Completions</strong></td></tr>

                      <tr><td>Agent Hangup</td><td>Agent hangup the
                      call</td></tr>

                      <tr><td>Normal Hangup</td><td>Call terminated
                      normally</td></tr>

                      <tr><td>End of XML Instructions</td><td>No more XML
                      instructions to execute</td></tr>

                      <tr><td>Multipart Call Ended</td><td>MPC ended via API or
                      max duration</td></tr>

                      <tr><td>Kicked Out of Multiparty Call</td><td>Participant
                      removed via API</td></tr>

                      <tr><td colspan="2"><strong>Canceled
                      Calls</strong></td></tr>

                      <tr><td>Unknown</td><td>Hangup reason
                      undetermined</td></tr>

                      <tr><td>Canceled</td><td>Call canceled via Hangup Call API
                      before answer</td></tr>

                      <tr><td>Canceled (Out of Credits)</td><td>Account ran out
                      of credits</td></tr>

                      <tr><td>Canceled (Simultaneous dial limit
                      reached)</td><td>Simultaneous dial limit
                      exceeded</td></tr>

                      <tr><td colspan="2"><strong>Destination
                      Issues</strong></td></tr>

                      <tr><td>Invalid Destination Address</td><td>Destination
                      number/endpoint invalid</td></tr>

                      <tr><td>Destination Out of Service</td><td>Destination
                      unavailable</td></tr>

                      <tr><td>Endpoint Not Registered</td><td>SIP endpoint
                      unregistered/unreachable</td></tr>

                      <tr><td>Destination Country Barred</td><td>Country
                      disabled in geo permissions</td></tr>

                      <tr><td>Destination Number Barred</td><td>Premium rate
                      numbers disabled</td></tr>

                      <tr><td>Destination Prefix Barred</td><td>Prefix not
                      permitted</td></tr>

                      <tr><td>Loop Detected</td><td>B-leg would redial A leg's
                      number</td></tr>

                      <tr><td>Violates Media Anchoring</td><td>India PSTN
                      regulation violation</td></tr>

                      <tr><td colspan="2"><strong>Call
                      Rejections</strong></td></tr>

                      <tr><td>No Answer</td><td>Destination
                      unavailable/unreachable</td></tr>

                      <tr><td>Busy Line</td><td>Destination is busy</td></tr>

                      <tr><td>Rejected</td><td>Call rejected by called
                      party</td></tr>

                      <tr><td>Unkown Caller ID</td><td>Non-Plivo number used as
                      caller ID</td></tr>

                      <tr><td>Forbiddden</td><td>Destination rejected/blocked
                      call</td></tr>

                      <tr><td>Unallocated number</td><td>Destination invalid or
                      out of service</td></tr>

                      <tr><td colspan="2"><strong>Carrier
                      Errors</strong></td></tr>

                      <tr><td>Request timeout</td><td>Carrier didn't respond in
                      time</td></tr>

                      <tr><td>Internal server error from carrier</td><td>Carrier
                      encountered error</td></tr>

                      <tr><td>Network congestion from carrier</td><td>Carrier
                      network overloaded</td></tr>

                      <tr><td>Busy everywhere</td><td>All destination endpoints
                      busy</td></tr>

                      <tr><td>Declined</td><td>Destination cannot/won't
                      participate</td></tr>

                      <tr><td>User does not exist anywhere</td><td>End user
                      doesn't exist</td></tr>

                      <tr><td>Spam block</td><td>Carrier rejected due to spam
                      flag</td></tr>

                      <tr><td>DNO Caller ID</td><td>Caller ID on Do
                      Not</td></tr>

                      <tr><td colspan="2"><strong>System
                      Errors</strong></td></tr>

                      <tr><td>Network Error</td><td>Fatal network
                      condition</td></tr>

                      <tr><td>Internal Error</td><td>Plivo system
                      error</td></tr>

                      <tr><td>Routing Error</td><td>Could not route to
                      destination</td></tr>

                      <tr><td>Concurrency Limit Breached</td><td>India
                      concurreny call limit exceeded</td></tr>

                      <tr><td colspan="2"><strong>Timeouts</strong></td></tr>

                      <tr><td>Scheduled Hangup</td><td>Max call duration
                      reached</td></tr>

                      <tr><td>Ring Timeout Reached</td><td>Not answered within
                      ring timeout</td></tr>

                      <tr><td>Media Timeout</td><td>No media packets for 60
                      seconds</td></tr>

                      <tr><td colspan="2"><strong>URL Errors</strong></td></tr>

                      <tr><td>Error Reaching Answer URL</td><td>Non-2xx response
                      from answer URL</td></tr>

                      <tr><td>Error Reaching Action URL</td><td>Non-2xx response
                      from action URL</td></tr>

                      <tr><td>Error Reaching Transfer URL</td><td>Non-2xx
                      response from transfer URL</td></tr>

                      <tr><td>Error Reaching Redirect URL</td><td>Non-2xx
                      response from redirect URL</td></tr>

                      <tr><td>Invalid Action URL</td><td>Action URL not
                      valid</td></tr>

                      <tr><td>Invalid Transfer URL</td><td>Transfer URL not
                      valid</td></tr>

                      <tr><td>Invalid Redirect URL</td><td>Redirect URL not
                      valid</td></tr>

                      <tr><td>Invalid Method for Action URL</td><td>Unsupported
                      HTTP method</td></tr>

                      <tr><td>Invalid Method for Transfer
                      URL</td><td>Unsupported HTTP method</td></tr>

                      <tr><td>Invalid Method for Redirect
                      URL</td><td>Unsupported HTTP method</td></tr>

                      <tr><td colspan="2"><strong>XML Errors</strong></td></tr>

                      <tr><td>Invalid Answer XML</td><td>Answer URL returned
                      invalid XML</td></tr>

                      <tr><td>Invalid Action XML</td><td>Action URL returned
                      invalid XML</td></tr>

                      <tr><td>Invalid Transfer XML</td><td>Transfer URL returned
                      invalid XML</td></tr>

                      <tr><td>Invalid Redirect XML</td><td>Redirect URL returned
                      invalid XML</td></tr>

                      <tr><td colspan="2"><strong>Special
                      Cases</strong></td></tr>

                      <tr><td>Lost Race</td><td>Another parallel B-leg answered
                      first</td></tr>

                      <tr><td>Machine Detected</td><td>Answered by answering
                      machine</td></tr>

                      <tr><td>Confirm Key Challenge Failed</td><td>Participant
                      failed to enter confirm key</td></tr>

                      </tbody>

                      </table>


                      </details>
              example:
                success: true
                data:
                  calls:
                    - id: b98d6318-5e5c-40c1-b9b3-805688506d92
                      assistantId: 88c05f57-4aa2-40a6-b12a-848596260dae
                      type: null
                      cost: 0.02
                      endedReason: Customer Hangup
                      status: ended
                      startedAt: '2026-04-20T06:59:42.449948+00:00'
                      endedAt: '2026-04-20T07:00:02.943036+00:00'
                      transcript:
                        - id: item_86abffec7b54
                          type: message
                          role: assistant
                          content:
                            - नमस्ते! मैं पूजा बोल रही हूँ, आवरण होम प्लस से।
                          interrupted: false
                          extra: {}
                          metrics:
                            tts_node_ttfb: 0.2542913980000776
                          created_at: '2026-04-20T06:59:46.379377+00:00'
                          message: नमस्ते! मैं पूजा बोल रही हूँ, आवरण होम प्लस से।
                        - id: item_d16599786c31
                          type: message
                          role: assistant
                          content:
                            - Can you hear me?
                          interrupted: false
                          extra: {}
                          metrics:
                            started_speaking_at: 1776668389.9128273
                            stopped_speaking_at: 1776668390.9525201
                            tts_node_ttfb: 0.14719204099992567
                          created_at: '2026-04-20T06:59:50.952606+00:00'
                          message: Can you hear me?
                        - id: item_d90d02b3164c
                          type: message
                          role: assistant
                          content:
                            - Are you there?
                          interrupted: false
                          extra: {}
                          metrics:
                            started_speaking_at: 1776668394.9146988
                            stopped_speaking_at: 1776668395.8504355
                            tts_node_ttfb: 0.14871830199990654
                          created_at: '2026-04-20T06:59:55.850494+00:00'
                          message: Are you there?
                      recordingUrl: >-
                        https://static.pathora.in/pluto_recordings/b98d6318-5e5c-40c1-b9b3-805688506d92.ogg
                      summary:
                        Summary: >-
                          The customer did not respond during the call. No
                          information or intent was provided.
                        Remarks:
                          Intent: None
                          Next Call-to-Action: None
                        Call Outcome:
                          RSVP: None
                          Callback Requested: None
                          Callback Timeframe: None
                          Key Questions/Concerns: None
                          Follow-up Actions: None
                        Customer Stage:
                          Stage: Not Picked
                        Additional Notes:
                          Objections/Concerns: None
                          Visit Commitment: None
                      createdAt: '2026-04-20T06:59:42.449948+00:00'
                      updatedAt: '2026-04-20T07:00:02.943036+00:00'
                      orgId: user_3763mSwxXbCByARq7E92FpJcJ71
                      call_duration_seconds: 20.493088
                      agent_id: 88c05f57-4aa2-40a6-b12a-848596260dae
                      user_id: user_3763mSwxXbCByARq7E92FpJcJ71
                      campaign_id: demo_call_web
                      to_number: null
                      from_number: null
                      telecom_total_cost: null
                      call_direction: null
                      contact_name: null
                  total: 1
                  total_cost: 0.02
                  avg_duration: 20.49
                  total_duration: 20.49
        '400':
          $ref: '#/components/responses/BadRequest'
        '401':
          $ref: '#/components/responses/Unauthorized'
        '404':
          $ref: '#/components/responses/NotFound'
        '500':
          $ref: '#/components/responses/InternalServerError'
        '501':
          $ref: '#/components/responses/NotImplemented'
      x-codeSamples:
        - lang: curl
          label: cURL
          source: |-
            curl --request POST \\
              --url https://voip-middlware.superu.ai/call-logs/all?limit=20&page=1&before=2026-02-01T00%3A00%3A00Z&after=2026-01-01T00%3A00%3A00Z&status=completed&campaign_id=demo_call&search_query=Ava \\
              --header 'superU-Api-Key: YOUR_SUPERU_API_KEY'
        - lang: python
          label: Python
          source: |-
            from superu import SuperU

            client = SuperU("YOUR_SUPERU_API_KEY")

            response = client.call_logs.get_logs(
                assistant_id="all",
                limit=20,
                page=1,
                before="2026-02-01T00:00:00Z",
                after="2026-01-01T00:00:00Z",
                status="completed",
                campaign_id="demo_call",
                search_query="Ava"
            )
            print(response)
components:
  responses:
    BadRequest:
      description: Bad Request - invalid parameters or payload.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            code: BAD_REQUEST
            message: Request validation failed.
    Unauthorized:
      description: Unauthorized - missing or invalid API key.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            code: UNAUTHORIZED
            message: Invalid or missing superU-Api-Key.
    NotFound:
      description: Not Found - requested resource does not exist.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            code: NOT_FOUND
            message: Resource not found.
    InternalServerError:
      description: Internal Server Error - unexpected backend error.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            code: INTERNAL_SERVER_ERROR
            message: An unexpected server error occurred.
    NotImplemented:
      description: >-
        Not Implemented - this action is not available in the current
        deployment.
      content:
        application/json:
          schema:
            $ref: '#/components/schemas/ErrorResponse'
          example:
            status: error
            code: NOT_IMPLEMENTED
            message: This endpoint is not implemented for your workspace.
  schemas:
    ErrorResponse:
      type: object
      required:
        - message
      properties:
        status:
          type: string
          example: error
          description: Status value.
        message:
          type: string
          example: Invalid request payload
          description: Message value.
        error:
          type: string
          example: Bad Request
          description: Error value.
        code:
          type: string
          example: BAD_REQUEST
          description: Code value.
      additionalProperties: true
      description: Error Response schema.
  securitySchemes:
    superUApiKey:
      type: apiKey
      in: header
      name: superU-Api-Key
      description: Your SuperU API key.

````