> ## 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.

# Bulk Call Status

> Get the status of multiple campaign calls in bulk.
- **callIds**: A list of campaign call IDs to retrieve statuses for.



## OpenAPI

````yaml https://api-prod.interactly.ai/api-docs/campaigns/api.json post /campaigns/v1/insurance-calling/calls/status
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/insurance-calling/calls/status:
    post:
      tags:
        - Campaign Bulk Calls
        - Bulk Calls
      summary: Bulk Call Status
      description: |-
        Get the status of multiple campaign calls in bulk.
        - **callIds**: A list of campaign call IDs to retrieve statuses for.
      operationId: >-
        campaigns_service_bulk_call_status_v1_insurance_calling_calls_status_post
      parameters: []
      requestBody:
        required: true
        content:
          application/json:
            schema:
              type: object
              properties:
                callIds:
                  type: array
                  items:
                    type: string
                  description: List of call record IDs to retrieve status for
              required:
                - callIds
            example:
              callIds:
                - 64f1a2b3c4d5e6f7a8b9c0d1
                - 64f1a2b3c4d5e6f7a8b9c0d2
      responses:
        '200':
          description: Status records for each requested call ID
          content:
            application/json:
              schema:
                type: array
                items:
                  properties:
                    record_id:
                      description: Call record ID
                      title: Record Id
                      type: string
                    status:
                      description: >-
                        Resolved call status after applying review logic.
                        Possible values: 'received', 'ready', 'queued',
                        'ringing', 'processing', 'ended', 'completed', 'failed',
                        'incomplete'
                      title: Status
                      type: string
                    failure_reason:
                      anyOf:
                        - type: string
                        - type: 'null'
                      description: Error message when the call failed
                      title: Failure Reason
                    input:
                      additionalProperties: true
                      description: >-
                        Decrypted call payload — the data submitted at upload
                        time
                      title: Input
                      type: object
                    output:
                      additionalProperties: true
                      description: >-
                        Structured data collected by the AI assistant during the
                        call
                      title: Output
                      type: object
                    phone_call_artifacts:
                      properties:
                        audio_uri:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: >-
                            Signed URL for the call audio recording (valid 48
                            hours)
                          title: Audio Uri
                        transcript_uri:
                          anyOf:
                            - type: string
                            - type: 'null'
                          description: Signed URL for the call transcript (valid 48 hours)
                          title: Transcript Uri
                      title: PhoneCallArtifacts
                      type: object
                      description: Signed URLs for the call recording and transcript
                  required:
                    - record_id
                    - status
                  title: BulkCallStatusRecord
                  type: object
        '400':
          description: Bad request — invalid input or constraint violation
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '404':
          description: Requested resource not found
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal server error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ErrorResponse'
      security:
        - bearer: []
components:
  schemas:
    ErrorResponse:
      properties:
        message:
          type: string
          title: Message
          description: Human-readable error description
          examples:
            - Resource not found.
      type: object
      required:
        - message
      title: ErrorResponse
    HTTPValidationError:
      properties:
        detail:
          items:
            $ref: '#/components/schemas/ValidationError'
          type: array
          title: Detail
      type: object
      title: HTTPValidationError
    ValidationError:
      properties:
        loc:
          items:
            anyOf:
              - type: string
              - type: integer
          type: array
          title: Location
        msg:
          type: string
          title: Message
        type:
          type: string
          title: Error Type
      type: object
      required:
        - loc
        - msg
        - type
      title: ValidationError
  securitySchemes:
    bearer:
      scheme: bearer
      bearerFormat: Bearer
      type: http
      description: >-
        Retrieve your API Key from [Dashboard API Keys
        Section](https://dashboard.interactly.ai/api-keys).

````