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

# List Calls

> Fetch a paginated list of call records for a campaign.

- **page** / **size**: Pagination (default: page=1, size=50, max size=200).
- **start** / **end**: ISO 8601 date range filter on call creation date.
- **status**: Filter by call status (received, ready, queued, ringing, processing, ended, completed, failed).
- **search**: Search term matched against phone number or other call fields.
- **outcomes**: Repeat to filter by multiple outcomes: `?outcomes=voicemail&outcomes=no_answer`.
- **tags**: Repeat to filter by multiple tags: `?tags=region:west&tags=priority:high`.
- **groupId**: When provided, returns calls across all campaign runs in the group.



## OpenAPI

````yaml https://api-prod.interactly.ai/api-docs/sms/api.json get /campaigns/v1/campaigns/{campaign_id}/calls/list
openapi: 3.1.0
info:
  title: Interactly API
  description: API for building interactly.ai services
  version: 1.1.0
  contact:
    name: Interactly
    url: https://interactly.ai
    email: developers@interactly.ai
servers:
  - url: https://api-prod.interactly.ai
    description: API Server
security: []
paths:
  /campaigns/v1/campaigns/{campaign_id}/calls/list:
    get:
      tags:
        - Campaigns Calls
        - Campaign Calls
      summary: List Calls
      description: >-
        Fetch a paginated list of call records for a campaign.


        - **page** / **size**: Pagination (default: page=1, size=50, max
        size=200).

        - **start** / **end**: ISO 8601 date range filter on call creation date.

        - **status**: Filter by call status (received, ready, queued, ringing,
        processing, ended, completed, failed).

        - **search**: Search term matched against phone number or other call
        fields.

        - **outcomes**: Repeat to filter by multiple outcomes:
        `?outcomes=voicemail&outcomes=no_answer`.

        - **tags**: Repeat to filter by multiple tags:
        `?tags=region:west&tags=priority:high`.

        - **groupId**: When provided, returns calls across all campaign runs in
        the group.
      operationId: >-
        campaigns_service_get_campaigns_call_list_v1_campaigns__campaign_id__calls_list_get
      parameters:
        - name: campaign_id
          in: path
          required: true
          schema:
            $ref: 41c3fdbf-06a7-4b35-b7c6-cb19760a1d63
            description: Campaign configuration ID
          description: Campaign configuration ID
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Call status
            title: Status
          description: Call status
        - name: search
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Search keywords
            title: Search
          description: Search keywords
        - name: outcomes
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
              - type: 'null'
            description: Outcome values to filter by
            title: Outcomes
          description: Outcome values to filter by
        - name: tags
          in: query
          required: false
          schema:
            anyOf:
              - type: array
                items:
                  type: string
              - type: 'null'
            description: 'Filter by tags (format: key:value)'
            title: Tags
          description: 'Filter by tags (format: key:value)'
        - name: groupId
          in: query
          required: false
          schema:
            anyOf:
              - type: string
              - type: 'null'
            description: Filter by group ID
            title: Groupid
          description: Filter by group ID
        - name: is_deleted
          in: query
          required: false
          schema:
            type: boolean
            description: When true, return only soft-deleted calls
            default: false
            title: Is Deleted
          description: When true, return only soft-deleted calls
        - name: size
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: Number of items per page
            default: 300
            title: Size
          description: Number of items per page
        - name: page
          in: query
          required: false
          schema:
            type: integer
            minimum: 1
            description: Page number
            default: 1
            title: Page
          description: Page number
        - name: start
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Filter by start time (ISO 8601 format)
            title: Start
          description: Filter by start time (ISO 8601 format)
        - name: end
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            description: Filter by end time (ISO 8601 format)
            title: End
          description: Filter by end time (ISO 8601 format)
      responses:
        '200':
          description: Paginated list of call records
          content:
            application/json:
              schema:
                $ref: 0a84c04b-f239-4107-9de3-a6ee12448f7f
        '400':
          description: Bad request — invalid input or constraint violation
          content:
            application/json:
              schema:
                $ref: e525ba89-10eb-466b-acde-70640ae0f189
        '404':
          description: Requested resource not found
          content:
            application/json:
              schema:
                $ref: e525ba89-10eb-466b-acde-70640ae0f189
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: 61188eef-82a8-4002-94b5-80ed8ff45c7a
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: e525ba89-10eb-466b-acde-70640ae0f189
      security:
        - bearer: []
components:
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: Bearer
      type: http
      description: >-
        Retrieve your API Key from [Dashboard API Keys
        Section](https://dashboard.interactly.ai/api-keys).

````