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

# List call ids

> Return the ids of every call matching the same filters as the call list, newest first, capped at 1000. Meant for select-all bulk actions.



## OpenAPI

````yaml /api-reference/openapi.json get /v1/call/ids
openapi: 3.1.0
info:
  title: Diga API
  version: 0.1.0
servers:
  - url: https://api.diga.io
    description: Production
security: []
paths:
  /v1/call/ids:
    get:
      tags:
        - Calls
      summary: List call ids
      description: >-
        Return the ids of every call matching the same filters as the call list,
        newest first, capped at 1000. Meant for select-all bulk actions.
      operationId: list_call_ids_v1_call_ids_get
      parameters:
        - name: agent_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Agent Id
        - name: status
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/CallStatus'
              - type: 'null'
            title: Status
        - name: type
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/CallType'
              - type: 'null'
            title: Type
        - name: start_created_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: Start Created Date
        - name: end_created_date
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: date-time
              - type: 'null'
            title: End Created Date
        - name: contact_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Contact Id
        - name: phone_id
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                format: uuid
              - type: 'null'
            title: Phone Id
        - name: contact_phone
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 3
              - type: 'null'
            title: Contact Phone
        - name: search
          in: query
          required: false
          schema:
            anyOf:
              - type: string
                minLength: 2
              - type: 'null'
            title: Search
        - name: end_reason
          in: query
          required: false
          schema:
            anyOf:
              - $ref: '#/components/schemas/EndReason'
              - type: 'null'
            title: End Reason
      responses:
        '200':
          description: Successful Response
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/CallIdsResponse'
        '400':
          description: Bad request - Invalid field
          content:
            application/json:
              example:
                status: error
                error_code: NOT_VALID_FIELD
                message: Invalid field value in query parameters
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
        '422':
          description: Validation Error
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/HTTPValidationError'
        '500':
          description: Internal Server Error
          content:
            application/json:
              example:
                status: error
                error_code: INTERNAL_SERVER_ERROR
                message: 'Error: Internal Server Error'
              schema:
                $ref: '#/components/schemas/ErrorResponseSchema'
      security:
        - CustomHTTPBearer: []
components:
  schemas:
    CallStatus:
      type: string
      enum:
        - dialing
        - in_queue
        - in_progress
        - completed
      title: CallStatus
      description: >-
        Call lifecycle state. Only four states: a call is dialing, waiting in
        the

        queue, in progress, or completed. Every terminal outcome — answered,

        transferred, refused, no-answer, errored — is COMPLETED; the specific

        outcome lives in ``Call.end_reason`` (see EndReason).
    CallType:
      type: string
      enum:
        - inbound
        - outbound
      title: CallType
    EndReason:
      type: string
      enum:
        - user_hang_up
        - agent_hang_up
        - user_did_not_answer
        - answering_machine_detected
        - voicemail_left
        - mailbox_unavailable
        - ivr_unreachable
        - ivr_no_answer
        - path_completed
        - transfer
        - error
        - pre_call_flow_failed
        - concurrency_limit
        - no_remaining_seconds
        - user_left_queue
        - queue_timeout
        - unknown
      title: EndReason
    CallIdsResponse:
      properties:
        call_ids:
          items:
            type: string
            format: uuid
          type: array
          title: Call IDs
          description: Ids of the calls matching the filters.
        total:
          type: integer
          title: Total
          description: Number of ids returned.
      type: object
      required:
        - call_ids
        - total
      title: CallIdsResponse
    ErrorResponseSchema:
      properties:
        status:
          type: string
          title: Status
          description: Status of the response, always 'error' for error responses
          default: error
        error_code:
          type: string
          title: Error Code
          description: Machine-readable error code in SCREAMING_SNAKE_CASE format
          examples:
            - PROJECT_NOT_FOUND
            - INVALID_EMAIL
            - UNAUTHORIZED_ROLE
        message:
          type: string
          title: Message
          description: Human-readable error message with details
          examples:
            - Project with id 550e8400-e29b-41d4-a716-446655440000 not found
            - The email invalid@email is not valid
            - Insufficient permissions to perform this action
      type: object
      required:
        - error_code
        - message
      title: ErrorResponseSchema
      description: Standard error response format for all API errors.
    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:
    CustomHTTPBearer:
      type: http
      scheme: bearer

````

This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.