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

# Search Calls

> Returns 50 calls per page by default. `pagination.limit` sets the page-size
cap and must be between 1 and 250; `first` and `last` are capped by it.

Call reporting data is refreshed daily. Recent calls may not appear until
the following day, and refresh timing may vary.

<Warning>
  <strong>Beta Feature:</strong> This functionality is currently in beta. You
  may experience changes or limited support as we continue to improve it.
</Warning>


## OpenAPI

````yaml POST /calls/search
openapi: 3.1.0
info:
  title: api
  version: 0.1.0
  contact: {}
servers:
  - url: https://api.vooma.ai/v0
    description: Vooma API
security: []
paths:
  /calls/search:
    post:
      tags:
        - Calls
      description: >-
        Returns 50 calls per page by default. `pagination.limit` sets the
        page-size

        cap and must be between 1 and 250; `first` and `last` are capped by it.


        Call reporting data is refreshed daily. Recent calls may not appear
        until

        the following day, and refresh timing may vary.
      operationId: GetCalls
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/CallsV0.GetCallsInput'
            example:
              dateFilter:
                start: '2026-09-01T00:00:00Z'
                end: '2026-09-02T00:00:00Z'
              pagination:
                first: 50
      responses:
        '200':
          description: Ok
          content:
            application/json:
              schema:
                allOf:
                  - $ref: '#/components/schemas/CallsV0.GetCallsPayload'
                  - $ref: '#/components/schemas/V0.PaginatedResponse'
      security:
        - bearer: []
components:
  schemas:
    CallsV0.GetCallsInput:
      properties:
        pagination:
          $ref: '#/components/schemas/VoomaPublicAPIv0.Pagination'
        dateFilter:
          $ref: '#/components/schemas/CallsDateFilter'
      required:
        - dateFilter
      type: object
    CallsV0.GetCallsPayload:
      properties:
        calls:
          items:
            $ref: '#/components/schemas/Call'
          type: array
      required:
        - calls
      type: object
    V0.PaginatedResponse:
      properties:
        pageInfo:
          properties:
            endCursor:
              type: string
            startCursor:
              type: string
            hasPreviousPage:
              type: boolean
            hasNextPage:
              type: boolean
          type: object
        totalCount:
          type: number
          format: double
        count:
          type: number
          format: double
      type: object
    VoomaPublicAPIv0.Pagination:
      properties:
        limit:
          type: integer
          format: int32
        after:
          type: string
        before:
          type: string
        last:
          type: integer
          format: int32
        first:
          type: integer
          format: int32
      type: object
    CallsDateFilter:
      properties:
        end:
          type: string
          format: date-time
          description: Include calls that started at or before this UTC timestamp.
        start:
          type: string
          format: date-time
          description: Include calls that started at or after this UTC timestamp.
      required:
        - end
        - start
      type: object
    Call:
      properties:
        conversationId:
          type: string
        callExternalIdentifier:
          type: string
          nullable: true
        initiationDirection:
          type: string
          nullable: true
        fromPhoneNumber:
          type: string
          nullable: true
        toPhoneNumber:
          type: string
          nullable: true
        startTimeUtc:
          type: string
          format: date-time
        endTimeUtc:
          type: string
          format: date-time
          nullable: true
        durationSeconds:
          type: number
          format: double
          nullable: true
        talkDurationSeconds:
          type: number
          format: double
          nullable: true
        status:
          type: string
          nullable: true
        wasTransferAttempted:
          type: boolean
          nullable: true
        wasTransferAccepted:
          type: boolean
          nullable: true
        outcomeLabels:
          items:
            $ref: '#/components/schemas/CallOutcomeLabel'
          type: array
          description: Model-generated labels describing how the call ended.
        eventLabels:
          items:
            $ref: '#/components/schemas/CallEventLabel'
          type: array
          description: Model-generated labels describing funnel events during the call.
        customerSentiment:
          type: string
          nullable: true
          description: >-
            Model-generated sentiment; null when post-call analysis is
            unavailable.
        transcriptSummary:
          type: string
          nullable: true
          description: Model-generated summary.
        transferSummary:
          type: string
          nullable: true
        voomaCallLink:
          type: string
      required:
        - conversationId
        - callExternalIdentifier
        - initiationDirection
        - fromPhoneNumber
        - toPhoneNumber
        - startTimeUtc
        - endTimeUtc
        - durationSeconds
        - talkDurationSeconds
        - status
        - wasTransferAttempted
        - wasTransferAccepted
        - outcomeLabels
        - eventLabels
        - customerSentiment
        - transcriptSummary
        - transferSummary
        - voomaCallLink
      type: object
      additionalProperties: false
    CallOutcomeLabel:
      properties:
        rationale:
          type: string
        outcome:
          type: string
      required:
        - rationale
        - outcome
      type: object
    CallEventLabel:
      properties:
        rationale:
          type: string
        event:
          type: string
        order:
          type: number
          format: double
      required:
        - rationale
        - event
        - order
      type: object
  securitySchemes:
    bearer:
      type: http
      scheme: bearer
      bearerFormat: API Key

````