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

# Get Calls

> Returns a paginated list of calls for this tenant


## OpenAPI

````yaml https://realtime.govworx.net/u/api-docs get /realtime/v1/call
openapi: 3.1.0
info:
  title: GovWorx Realtime API
  description: >-
    Interfaces to access processing of realtime call data, transcriptions and
    CommsCoach Assist agentic outputs
  termsOfService: http://swagger.io/terms/
  version: '1.0'
servers:
  - url: https://realtime.govworx.net
security: []
tags:
  - name: Realtime Calls
    description: Endpoints for managing and interacting with active or completed calls
  - name: CAD Integration Handler
    description: >
      Implement these endpoints if you are a CAD vendor building an integration
      with Assist.


      These endpoints allow Assist to directly push data to your system.


      The base URL in the documentation (/cad-integration-handler) is
      illustrative and you may use a different base URL.


      You must implement the endpoints under the base URL using the given
      specifications, however.
  - name: Authentication
    description: Manage short-lived tokens for accessing the Realtime API.
  - name: CAD Integration
    description: Endpoints for managing and interacting with the CAD Integration.
  - name: Webhook Registration
    description: Register webhook handlers to receive notifications.
  - name: Webhook Handlers
    description: >-
      Implement these endpoints as needed to match any webhooks you have
      registered for. The URL in the documentation is illustrative. You must
      handle the webhook at the URL you registered. See 'Webhook Registration'.
externalDocs:
  description: GovWorx Developer Docs
  url: https://api.govworx.ai
paths:
  /realtime/v1/call:
    get:
      tags:
        - Realtime Calls
      summary: Get Calls
      description: Returns a paginated list of calls for this tenant
      operationId: getRealtimeCalls
      parameters:
        - name: page
          in: query
          description: Page number (1-based)
          required: false
          schema:
            type: integer
            default: 1
            minimum: 1
          example: 1
        - name: size
          in: query
          description: Number of results per page (max 50)
          required: false
          schema:
            type: integer
            default: 25
            maximum: 50
            minimum: 1
          example: 25
        - name: summary
          in: query
          description: Include call summary in the response
          required: false
          schema:
            type: boolean
            default: false
          example: true
      responses:
        '200':
          description: Returns a paginated list of calls
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/RealtimeCallPageResponse'
        '401':
          description: Failed to authenticate request
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/RealtimeCallPageResponse'
        '403':
          description: Not authorized to access these calls
          content:
            '*/*':
              schema:
                $ref: '#/components/schemas/RealtimeCallPageResponse'
components:
  schemas:
    RealtimeCallPageResponse:
      type: object
      description: Paginated response containing a list of calls
      properties:
        content:
          type: array
          description: List of calls for the current page
          items:
            $ref: '#/components/schemas/RealtimeCallDto'
        pageable:
          $ref: '#/components/schemas/PageableInfo'
          description: Pagination details
        last:
          type: boolean
          description: Whether this is the last page
        totalPages:
          type: integer
          format: int32
          description: Total number of pages
          example: 7
        totalElements:
          type: integer
          format: int64
          description: Total number of elements across all pages
          example: 34
        numberOfElements:
          type: integer
          format: int32
          description: Number of elements in the current page
          example: 5
        sort:
          $ref: '#/components/schemas/SortInfo'
          description: Sort information
        first:
          type: boolean
          description: Whether this is the first page
        size:
          type: integer
          format: int32
          description: Page size
          example: 5
        number:
          type: integer
          format: int32
          description: Current page number (0-indexed)
          example: 0
        empty:
          type: boolean
          description: Whether the page is empty
    RealtimeCallDto:
      type: object
      properties:
        id:
          type: string
        call_sid:
          type: string
        call_status:
          type: string
        created_at:
          type: string
          format: date-time
        started_at:
          type: string
          format: date-time
        summary:
          $ref: '#/components/schemas/CallSummary'
        call_socket:
          $ref: '#/components/schemas/CallSocket'
        call_details_record:
          $ref: '#/components/schemas/CallDetailsRecordSummaryDto'
        call_locations:
          type: array
          items:
            $ref: '#/components/schemas/CallLocationDto'
        viewers:
          type: array
          items:
            $ref: '#/components/schemas/CallViewerDto'
          uniqueItems: true
        agencies:
          type: array
          items:
            $ref: '#/components/schemas/AgencyDto'
          uniqueItems: true
    PageableInfo:
      type: object
      description: Pagination metadata
      properties:
        pageNumber:
          type: integer
          format: int32
          description: Current page number (0-indexed)
          example: 0
        pageSize:
          type: integer
          format: int32
          description: Page size
          example: 5
        sort:
          $ref: '#/components/schemas/SortInfo'
          description: Sort information
        offset:
          type: integer
          format: int64
          description: Offset from the beginning
          example: 0
        paged:
          type: boolean
          description: Whether pagination is enabled
        unpaged:
          type: boolean
          description: Whether pagination is disabled
    SortInfo:
      type: object
      description: Sort metadata
      properties:
        sorted:
          type: boolean
          description: Whether results are sorted
        unsorted:
          type: boolean
          description: Whether results are unsorted
        empty:
          type: boolean
          description: Whether sort is empty
    CallSummary:
      type: object
      properties:
        title:
          type: string
        summary:
          type: string
        nature:
          type: string
        location:
          type: string
        severity:
          type: string
        hazards:
          type: string
        timeSensitivity:
          type: string
        callerInfo:
          type: string
        suspectDetails:
          type: string
        ancillaryServices:
          type: string
        additionalRemarks:
          type: string
    CallSocket:
      type: object
      properties:
        token:
          $ref: '#/components/schemas/TokenDetails'
        channel:
          type: string
        updates_channel_host:
          type: string
        encryption_key:
          type: string
    CallDetailsRecordSummaryDto:
      type: object
      properties:
        ani_number:
          type: string
        call_duration_ms:
          type: integer
          format: int64
        call_started_at:
          type: string
          format: date-time
        call_answered_at:
          type: string
          format: date-time
        call_ended_at:
          type: string
          format: date-time
    CallLocationDto:
      type: object
      properties:
        latitude:
          type: number
          format: double
        longitude:
          type: number
          format: double
        accuracy:
          type: number
          format: double
        city:
          type: string
        state:
          type: string
        streetAddress:
          type: string
        country:
          type: string
        source:
          type: string
        createdAt:
          type: string
          format: date-time
    CallViewerDto:
      type: object
      properties:
        userId:
          type: integer
          format: int64
        firstName:
          type: string
        lastName:
          type: string
    AgencyDto:
      type: object
      properties:
        id:
          type: integer
          format: int64
        name:
          type: string
        code:
          type: string
        type:
          type: string
        geoAreaIds:
          type: array
          items:
            type: integer
            format: int64
        geoAreas:
          type: array
          items:
            $ref: '#/components/schemas/GeoAreaDto'
    TokenDetails:
      type: object
      properties:
        token:
          type: string
        expires:
          type: integer
          format: int64
        issued:
          type: integer
          format: int64
        capability:
          type: string
        clientId:
          type: string
    GeoAreaDto:
      type: object
      properties:
        id:
          type: integer
          format: int64
        properties:
          $ref: '#/components/schemas/GeoAreaProperties'
        geometry:
          type: object
          additionalProperties:
            type: object
    GeoAreaProperties:
      type: object
      properties:
        geoArea:
          type: string
        name:
          type: string
        color:
          type: string

````