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

# List Call Records (Minimal)

> Returns a paginated, lightweight list of voice-agent call records for a project. Each row carries only the fields needed for dashboard timelines (id, createdAt, status, agent, duration, channel, phone numbers). Filter by voice agent, one-or-many statuses, and a UTC time range on `createdAt`.

Timestamps are **UTC epoch milliseconds**. Convert the user's local window to UTC on the client before calling.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/voice-agents/conversations/minimal-list
openapi: 3.0.1
info:
  title: Hamsa API
  description: Trying out our transcription and media-to-text APIs
  license:
    name: MIT
  version: 1.0.0
servers:
  - url: https://api.tryhamsa.com
security: []
paths:
  /v1/voice-agents/conversations/minimal-list:
    get:
      tags:
        - Conversations
      summary: List call records (minimal)
      description: >-
        Returns a paginated, lightweight list of voice-agent call records for a
        project. Each row carries only the fields needed for dashboard timelines
        (id, createdAt, status, agent, duration, channel, phone numbers). Filter
        by voice agent, one-or-many statuses, and a UTC time range on
        `createdAt`.


        Timestamps are **UTC epoch milliseconds**. Convert the user's local
        window to UTC on the client before calling.
      parameters:
        - in: query
          name: voiceAgentId
          required: false
          description: Restrict results to a single voice agent.
          schema:
            type: string
            format: uuid
            example: 849e77c6-5cb3-479a-a985-7fab630e2c78
        - in: query
          name: status
          required: false
          description: >-
            One or many JobStatus values. Repeat the parameter for multiple
            values (e.g. `?status=COMPLETED&status=FAILED`).
          schema:
            type: array
            items:
              type: string
              enum:
                - PENDING
                - IN_PROGRESS
                - COMPLETED
                - NO_ANSWER
                - FAILED
                - FORWARDED
                - TERMINATED
            example:
              - COMPLETED
              - FAILED
        - in: query
          name: startTime
          required: false
          description: Inclusive lower bound on `createdAt`, as UTC epoch milliseconds.
          schema:
            type: integer
            example: 1747699200000
        - in: query
          name: endTime
          required: false
          description: >-
            Inclusive upper bound on `createdAt`, as UTC epoch milliseconds.
            Must be greater than or equal to `startTime` when both are provided.
          schema:
            type: integer
            example: 1747785600000
        - in: query
          name: page
          required: false
          description: 1-indexed page number.
          schema:
            type: integer
            default: 1
            minimum: 1
            example: 1
        - in: query
          name: perPage
          required: false
          description: Number of records per page. Hard-capped at 200.
          schema:
            type: integer
            minimum: 1
            maximum: 200
            default: 100
            example: 100
      responses:
        '200':
          description: Successful response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ListMinimalCallsResponse'
        '400':
          description: Bad request - validation error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
        '401':
          description: Unauthorized
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
        '500':
          description: Server Side Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorSchema'
      security:
        - ApiKeyAuth: []
components:
  schemas:
    ListMinimalCallsResponse:
      type: object
      properties:
        success:
          type: boolean
          example: true
        message:
          type: string
          example: success
        data:
          type: object
          properties:
            total:
              type: integer
              description: Total number of records matching the filters across all pages.
              example: 137
            filtered:
              type: integer
              description: Number of records returned on this page (<= perPage).
              example: 2
            calls:
              type: array
              items:
                type: object
                properties:
                  id:
                    type: string
                    format: uuid
                    example: e01b0877-1849-49f5-b4c2-d789fe603ec8
                  createdAt:
                    type: string
                    format: date-time
                    example: '2025-11-29T13:24:13.221Z'
                  status:
                    type: string
                    enum:
                      - PENDING
                      - IN_PROGRESS
                      - COMPLETED
                      - NO_ANSWER
                      - FAILED
                      - FORWARDED
                      - TERMINATED
                    example: COMPLETED
                  voiceAgentId:
                    type: string
                    format: uuid
                    nullable: true
                    example: 1df8a0c5-d1c8-44bb-848f-8accf58f32e2
                  agentName:
                    type: string
                    nullable: true
                    example: Support Agent
                  duration:
                    type: number
                    nullable: true
                    description: >-
                      Call duration in seconds. Null for calls that did not
                      connect.
                    example: 35
                  channelType:
                    type: string
                    nullable: true
                    example: Telephone
                  callParams:
                    type: object
                    nullable: true
                    description: >-
                      Phone numbers involved in the call. Null for non-telephone
                      channels.
                    properties:
                      machineNumber:
                        type: string
                        example: '+16592225145'
                      userNumber:
                        type: string
                        example: '+201095987769'
    ErrorSchema:
      type: object
      properties:
        code:
          type: integer
        message:
          type: string
  securitySchemes:
    ApiKeyAuth:
      type: apiKey
      in: header
      name: Authorization
      description: >-
        Pass the API key in the Authorization header, You need to put Token
        keyword before the API key. e.g. 'Authorization: Token <api-key>'

````