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

GET /

Receive call.dial events

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

## AsyncAPI Specification

```yaml
asyncapi: 2.6.0
info:
  title: call.dial
  version: subpackage_callDial.call.dial
  description: Receive call.dial events
channels:
  /:
    description: Receive call.dial events
    publish:
      operationId: subpackage_callDial.call.dial-publish
      summary: call.dial
      message:
        name: onCallDialCallDialEvent
        title: call.dial
        payload:
          $ref: '#/components/schemas/call.dial_callDialEvent'
servers:
  production:
    url: wss://relay.signalwire.com/
    protocol: wss
    x-default: true
components:
  schemas:
    ChannelsCallDialMessagesCallDialEventJsonrpc:
      type: string
      enum:
        - '2.0'
      description: JSON-RPC version. Always `2.0`.
      title: ChannelsCallDialMessagesCallDialEventJsonrpc
    ChannelsCallDialMessagesCallDialEventMethod:
      type: string
      enum:
        - signalwire.event
      description: Always `signalwire.event`.
      title: ChannelsCallDialMessagesCallDialEventMethod
    ChannelsCallDialMessagesCallDialEventParamsEventType:
      type: string
      enum:
        - call.dial
      description: The event type — identifies which event this is.
      title: ChannelsCallDialMessagesCallDialEventParamsEventType
    FabricCallDialParamsDialState:
      type: string
      enum:
        - dialing
        - answered
        - failed
      description: Where the dial stands.
      title: FabricCallDialParamsDialState
    FabricCallDialParamsSource:
      type: string
      enum:
        - inbound
        - outbound
        - none
      description: >-
        Which side ended the dial: `inbound`, `outbound`, or `none`. Present
        together with `reason`.
      title: FabricCallDialParamsSource
    Fabric.CallDialParams:
      type: object
      properties:
        call_id:
          type: string
          description: >-
            The dial's `tag`. This event has no call ID of its own, so `call_id`
            carries the same value.
        room_session_id:
          type: string
          description: The dial's `tag`, repeated here.
        node_id:
          type: string
          description: The node that handled the dial.
        tag:
          type: string
          description: The `tag` the server-side application set on the dial.
        dial_state:
          $ref: '#/components/schemas/FabricCallDialParamsDialState'
          description: Where the dial stands.
        call:
          type: object
          additionalProperties:
            description: Any type
          description: >-
            The call leg the dial reached, in the same shape as the `call.state`
            payload without `room_session_id` or the timing and quality fields.
        reason:
          type: string
          description: Why the dial failed. Present when `dial_state` is `failed`.
        source:
          $ref: '#/components/schemas/FabricCallDialParamsSource'
          description: >-
            Which side ended the dial: `inbound`, `outbound`, or `none`. Present
            together with `reason`.
      required:
        - call_id
        - room_session_id
        - node_id
        - tag
        - dial_state
      description: >-
        Payload of the Call Fabric `call.dial` event: the outcome of a dial that
        reached the call leg.
      title: Fabric.CallDialParams
    ChannelsCallDialMessagesCallDialEventParams:
      type: object
      properties:
        event_type:
          $ref: >-
            #/components/schemas/ChannelsCallDialMessagesCallDialEventParamsEventType
          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.CallDialParams'
          description: The event-specific payload.
      required:
        - event_type
        - event_channel
        - timestamp
        - params
      description: The event envelope.
      title: ChannelsCallDialMessagesCallDialEventParams
    call.dial_callDialEvent:
      type: object
      properties:
        jsonrpc:
          $ref: '#/components/schemas/ChannelsCallDialMessagesCallDialEventJsonrpc'
          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/ChannelsCallDialMessagesCallDialEventMethod'
          description: Always `signalwire.event`.
        params:
          $ref: '#/components/schemas/ChannelsCallDialMessagesCallDialEventParams'
          description: The event envelope.
      required:
        - jsonrpc
        - id
        - method
        - params
      description: >-
        Fires when a dial reaches a Call Fabric call leg, reporting whether it
        was answered or failed. A server-side application starts the dial; there
        is no client request that starts it.
      title: call.dial_callDialEvent

```