> ## Documentation Index > Fetch the complete documentation index at: https://blackbox.dasha.ai/llms.txt > Use this file to discover all available pages before exploring further. # Get call queue > Retrieves the current call queue for your organization with filtering options. Shows scheduled and pending calls that have not yet been completed. Unlike the general call list endpoint, this focuses on active queue items. ## OpenAPI ````yaml https://blackbox.dasha.ai/swagger/v1/swagger.json get /api/v1/calls/queue/list openapi: 3.0.4 info: title: Dasha BlackBox Agent API description: API for managing AI agents and calls contact: name: DashaAI Team email: support@dasha.ai version: v1 servers: - url: https://blackbox.dasha.ai description: Dasha BlackBox Agent API security: - ApiKey: [] - OAuth: [] tags: - name: ActivityLogs - name: Agents - name: AgentTestCases - name: CallResults - name: Calls - name: Chats - name: Copilot - name: CustomerData - name: Mcp - name: Media - name: Misc - name: PronunciationDictionaries - name: Providers - name: SipAliases - name: SipCredentials - name: SipPhoneNumbers - name: TextChat - name: TwilioProvider - name: Voice - name: WebhookTest - name: WebIntegrations - name: WebSocket description: WebSocket endpoints for real-time communication paths: /api/v1/calls/queue/list: get: tags: - Calls summary: Get call queue description: >- Retrieves the current call queue for your organization with filtering options. Shows scheduled and pending calls that have not yet been completed. Unlike the general call list endpoint, this focuses on active queue items. parameters: - name: skip in: query description: Number of items to skip schema: maximum: 2147483647 minimum: 0 type: integer format: int32 default: 0 - name: take in: query description: Number of items to return schema: maximum: 1000 minimum: 1 type: integer format: int32 default: 20 - name: fromDate in: query description: Filter start date schema: type: string format: date-time - name: toDate in: query description: Filter end date schema: type: string format: date-time - name: agentId in: query description: Filter by agent schema: type: string - name: status in: query description: Filter by status array schema: type: array items: $ref: '#/components/schemas/CallStatus' responses: '200': description: Returns the call queue successfully content: application/json: schema: $ref: '#/components/schemas/CallListResponseDto' '400': description: Invalid pagination or filter parameters content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '401': description: Authentication failed or API key is missing content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '403': description: Access denied to organization resources content: application/json: schema: $ref: '#/components/schemas/ProblemDetails' '500': description: Server error occurred while retrieving queue components: schemas: CallStatus: enum: - Unknown - Created - Pending - Queued - Completed - Failed - Canceled - Running type: string description: >- Current status of a call in its lifecycle. Tracks the call's progress from creation through completion or failure. CallListResponseDto: required: - calls - total type: object properties: calls: type: array items: $ref: '#/components/schemas/CallEnqueueResponseDto' description: >- Calls in the current page. Each call includes configuration, status, scheduling information, and identifiers for tracking. total: type: integer description: >- Total number of calls matching the query across all pages. Use this to calculate pagination (e.g., total pages, remaining items) and display overall call volume. format: int32 additionalProperties: false description: >- Paginated list of calls with metadata. Contains a page of call records and the total count across all pages, allowing you to navigate through large call histories. ProblemDetails: type: object properties: type: type: string nullable: true title: type: string nullable: true status: type: integer format: int32 nullable: true detail: type: string nullable: true instance: type: string nullable: true additionalProperties: {} CallEnqueueResponseDto: required: - agentId - callId - createdTime - endpoint - nextScheduleTime - orgId - status type: object properties: endpoint: minLength: 1 type: string description: >- Phone number or SIP endpoint to call. The format depends on your SIP configuration and the type of call being made. additionalData: type: object additionalProperties: {} description: >- Data for variable interpolation in agent prompts. Values can be referenced in prompts using {{variableName}} syntax. Merge with agent's AdditionalData. nullable: true priority: type: integer description: >- Call priority for queue ordering. Higher priority calls are attempted before lower priority calls when multiple calls are queued. Useful for prioritizing urgent calls or VIP customers. format: int32 nullable: true callDeadline: type: string description: >- Deadline for completing the call attempt. If the call has not been successfully connected by this time, it will be marked as canceled. When not specified, defaults to current time plus 1 day, giving the system 24 hours to complete the call. format: date-time nullable: true timezone: type: string description: >- Timezone identifier for call scheduling (e.g., "America/New_York", "Europe/London"). Used to interpret scheduled call times in the recipient's local timezone. When not specified, the agent's timezone is used. nullable: true overrideOutboundConfig: allOf: - $ref: '#/components/schemas/OutboundConfigOverride' description: >- Override SIP configuration for this specific call. Allows using different outbound SIP settings, caller ID, or trunk configuration than the agent's default configuration. Useful for routing calls through specific carriers or presenting different caller IDs. nullable: true callId: minLength: 1 type: string description: >- Unique identifier for this call. Use this ID to query call status, retrieve call details, or cancel the call before it completes. orgId: minLength: 1 type: string description: >- Organization that owns this call. Used for access control and resource tracking. agentId: minLength: 1 type: string description: >- Agent that will handle this call. References the agent configuration used for the conversation logic, voice settings, and tool availability. createdTime: type: string description: Timestamp when the call was enqueued and entered the system. format: date-time status: allOf: - $ref: '#/components/schemas/CallStatus' description: >- Current status of the call. Possible values: Created (just enqueued), Pending (waiting to be processed), Queued (in call queue), Running (call in progress), Completed (successfully finished), Failed (error occurred), Canceled (manually canceled). nextScheduleTime: type: string description: >- Next scheduled time when the system will attempt to initiate this call. For immediate calls, this is typically very close to the creation time. For scheduled calls or retries, this reflects the next planned attempt. format: date-time additionalProperties: false description: >- Response after successfully enqueueing a call. Contains all call parameters from the request plus system-assigned identifiers, status, and scheduling information for tracking the call's lifecycle. OutboundConfigOverride: type: object properties: phoneNumber: maxLength: 255 type: string description: >- Phone number to use for this call instead of the agent's default. Overrides which number appears as the caller ID and which SIP registration is used for the call. default: null nullable: true credentialsId: type: string description: >- SIP credentials to use for this call instead of the agent's default. Allows routing the call through a different SIP trunk, useful for failover, cost optimization, or geographic routing. format: uuid default: null nullable: true displayName: maxLength: 255 type: string description: >- Display name to use for caller ID for this call instead of the phone number's default. Overrides the caller ID name shown to the recipient. default: null nullable: true additionalProperties: false description: >- Override outbound SIP configuration for a specific call. Allows using different phone number, credentials, or caller ID for individual calls without changing the agent's default configuration. Useful for multi-tenant scenarios, A/B testing different trunks, or presenting different caller IDs per customer. securitySchemes: ApiKey: type: http description: API Key Authentication (Bearer {key}) scheme: Bearer OAuth: type: oauth2 flows: implicit: authorizationUrl: https://auth.dasha.ai/connect/authorize scopes: platform_api: Platform API ````