> This page is for APIs.

> Fetch clean Markdown by appending `.md` to any page URL under https://signalwire.com/docs or requesting it with the HTTP header `Accept: text/markdown`. The root index at https://signalwire.com/docs/llms.txt lists the available documentation indexes.

# call.queue

GET /

Receive call.queue events

Reference: https://signalwire.com/docs/apis/relay/client/fabric/call-queue

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: call.queue
  version: subpackage_callQueue.call.queue
  description: Receive call.queue events
channels:
  /:
    description: Receive call.queue events
    publish:
      operationId: subpackage_callQueue.call.queue-publish
      summary: call.queue
      message:
        name: onCallQueueCallQueueEvent
        title: call.queue
        payload:
          $ref: '#/components/schemas/call.queue_callQueueEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsCallQueueMessagesCallQueueEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallQueueMessagesCallQueueEventJsonrpc
    ChannelsCallQueueMessagesCallQueueEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsCallQueueMessagesCallQueueEventMethod
    ChannelsCallQueueMessagesCallQueueEventParamsEventType:
      type: string
      enum:
        - call.queue
      description: The event type — identifies which event this is.
      title: ChannelsCallQueueMessagesCallQueueEventParamsEventType
    Fabric.CallQueueParams:
      type: object
      properties:
        call_id:
          type: string
          description: >-
            Unique identifier of the call this event is about. Always present on
            Fabric events.
        node_id:
          type: string
          description: The node the call leg lives on.
        room_session_id:
          type: string
          description: >-
            The room session this call leg belongs to. In a 1:1 call this equals
            the `call_id`.
        control_id:
          type: string
          description: The `control_id` of the queue session.
        status:
          type: string
          description: >-
            What happened: `enqueue`, `dequeue`, `leave`, or `stats` (a periodic
            position update). Handle unknown values gracefully.
        id:
          type: string
          description: The queue ID.
        name:
          type: string
          description: The queue name.
        position:
          type: integer
          description: The call's position in line, counting from the front.
        size:
          type: integer
          description: How many calls are waiting in the queue.
        avg_time:
          type: integer
          description: Average time calls spend in the queue, in seconds.
        enqueue_ts:
          type: integer
          format: int64
          description: >-
            When the call entered the queue, as a Unix timestamp in
            microseconds. `0` until then.
        dequeue_ts:
          type: integer
          format: int64
          description: >-
            When the call was pulled from the queue, as a Unix timestamp in
            microseconds. `0` until then.
        leave_ts:
          type: integer
          format: int64
          description: >-
            When the call left the queue, as a Unix timestamp in microseconds.
            `0` until then.
        status_url:
          type: string
          description: The status callback URL set for the queue. Empty when none was set.
      required:
        - call_id
        - node_id
        - room_session_id
        - control_id
        - status
        - id
        - name
        - position
        - size
        - avg_time
        - enqueue_ts
        - dequeue_ts
        - leave_ts
        - status_url
      description: Payload of the Call Fabric `call.queue` event.
      title: Fabric.CallQueueParams
    ChannelsCallQueueMessagesCallQueueEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsCallQueueMessagesCallQueueEventParamsEventType
          description: The event type — identifies which event this is.
        event_channel:
          type: string
          description: >-
            The channel the event was delivered on — for Calling events, the
            `protocol`

            string your connection received from `signalwire.connect`.
        timestamp:
          type: number
          format: double
          description: >-
            When the event was emitted, as a Unix timestamp in seconds. Always
            present.
        project_id:
          type: string
          description: >-
            Your project ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        space_id:
          type: string
          description: >-
            Your space ID. Present on Calling events and most Call Fabric
            events; absent on `call.joined`, `call.left`, `member.joined`, and
            `member.left`.
        params:
          $ref: '#/components/schemas/Fabric.CallQueueParams'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsCallQueueMessagesCallQueueEventParams
    call.queue_callQueueEvent:
      type: object
      properties:
        jsonrpc:
          $ref: '#/components/schemas/ChannelsCallQueueMessagesCallQueueEventJsonrpc'
          description: JSON-RPC version. Always `2.0`.
        id:
          type: string
          description: >-
            Event id — a unique UUID generated for each event. Events are
            notifications: you do not reply to them.
        method:
          $ref: '#/components/schemas/ChannelsCallQueueMessagesCallQueueEventMethod'
          description: Always `signalwire.event`.
        params:
          $ref: '#/components/schemas/ChannelsCallQueueMessagesCallQueueEventParams'
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires as a Call Fabric call leg moves through a queue: when it joins, is
        pulled to be connected, or leaves, plus periodic position updates. SWML
        or a server-side application places the leg in the queue; there is no
        client request that does.
      title: call.queue_callQueueEvent

```