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

# Detect status callback

POST 

Sent to the `status_url` of a `calling.detect` command each time the detector reports a result,
and with `finished` when it stops.

Status callbacks are advisory, best-effort notifications — delivery can be delayed or fail silently, so don't gate time-critical actions on receiving one. See [Status callback reliability](/docs/platform/webhooks#status-callback-reliability).

Reference: https://signalwire.com/docs/apis/rest/webhooks/detect-status-callback

## Request

### Payload

- `event_type` (enum, required) — The type of event. Always `calling.call.detect` for detect status callbacks.
  - Allowed values: `calling.call.detect`
- `event_channel` (string, required) — The channel the event was delivered on.
- `timestamp` (double, required) — When the event was sent, as a Unix timestamp in seconds.
- `project_id` (string, required) — Your project ID.
- `space_id` (string, required) — Your Space ID.
- `params` (WebhooksCallingDetectStatusCallbackPayloadParams, required) — The detect operation and what it detected.

## Types

### WebhooksCallingDetectStatusCallbackPayloadParams

The detect operation and what it detected.

- `call_id` (string, required) — ID of the call.
- `node_id` (string, required) — ID of the node the call is on.
- `control_id` (string, required) — The control ID of the detect operation, as set in `calling.detect`.
- `detect` (WebhooksCallingDetectStatusCallbackPayloadParamsDetect, required) — The detection result.
- `segment_id` (string, optional) — ID of the call segment. Present when the call has one.
- `tag` (string, optional) — The tag associated with the call. Present only when a tag was set on the call.

### WebhooksCallingDetectStatusCallbackPayloadParamsDetect

The detection result.

- `type` (enum, required) — The type of detection, as set in `calling.detect`.
  - Allowed values: `machine`, `fax`, `digit`
- `params` (WebhooksCallingDetectStatusCallbackPayloadParamsDetectParams, required) — The detected event.

### WebhooksCallingDetectStatusCallbackPayloadParamsDetectParams

The detected event.

- `event` (string, required) — What was detected. For `machine`: `MACHINE`, `HUMAN`, `UNKNOWN`, `READY`, or `NOT_READY`. For `digit`: the DTMF digit pressed. For `fax`: the fax tone detected. `finished` when the detector stops.
- `beep` (boolean, optional) — `true` when a beep was detected. Machine detection only.