---
title: "Outbound call ended"
method: POST
path: "v2.call.outbound.ended"
---

# Outbound call ended

`POST v2.call.outbound.ended` (webhook)

An outbound call has hung up

## Payload

- object
  - `id` string, required — Unique identifier for the event. Use this for idempotency checks.
  - `at` string, date-time, required — RFC 3339, section 5.6
  - `sid` string, required — Short ID
  - `type` 'v2.call.outbound.ended', required — - `v2.billing.credit.topup` = Your account has been credited with a new amount. - `v2.billing.credit.warning` = Your prepaid balance has reached its warning level. - `v2.billing.credit.shutdown` = Your prepaid balance has reached its shutdown level. Your account is suspended. - `v2.call.inbound.started` = An inbound call just started. - `v2.call.inbound.ended` = An inbound call just hung up. - `v2.call.outbound.started` = An outbound call just started. - `v2.call.outbound.ended` = An outbound call just hung up. - `v2.number.assigned` = A phone number was assigned to your account. - `v2.number.unassigned` = A phone number was unassigned from your account. - `v2.task.updated` = A task has been updated. - `v2.audio-file.updated` = An audio file has been updated. - `v2.recording.updated` = A recording has been updated. - `v2.sms.inbound.received` = An inbound SMS has been received. - `v2.sms.outbound.updated` = An outbound SMS has an updated status.
  - `try` integer, required — Number of attempts made to deliver the webhook
  - `payload` CDR, required
    - `direction` 'inbound' | 'outbound', required — The direction. Inbound is a call or an SMS received by the Callr platform. Outbound is a call or an SMS initiated by the Callr platform.
    - `callid` integer, required — Call ID
    - `bridged` integer — Call ID
    - `callerName` string, required — Caller ID Name
    - `callerNumber` string, required — A phone number in ITU-T E.164 format https://en.wikipedia.org/wiki/E.164, prefixed by "+"
    - `callerRestricted` boolean, required — Whether the Caller ID is restricted
    - `callee` string, required — A phone number in ITU-T E.164 format https://en.wikipedia.org/wiki/E.164, prefixed by "+"
    - `started` string, date-time, required — RFC 3339, section 5.6
    - `answered` string, date-time — RFC 3339, section 5.6
    - `ended` string, date-time — RFC 3339, section 5.6
    - `status` 'dialing' | 'ringing' | 'answered' | 'failed' | 'busy' | 'unallocated' | 'canceled'
    - `hangupSource` 'caller' | 'callee' | 'system'
    - `hangupCause` integer — Q.850 cause code
    - `hangupTech` string — Technology specific hangup cause
    - `durationTotal` integer
    - `durationAnswered` integer
    - `durationBilled` integer
    - `billingDestinationLabel` string, required
    - `billingDestinationID` integer
    - `billingDebit` string — Amount in cents
    - `billingCredit` string — Amount in cents
    - `billingPaymentType` 'postpaid' | 'prepaid', required — Either prepaid or postpaid
    - `scenarioSid` string, required — Short ID
    - `scenarioName` string, required
    - `scenarioTypeName` string, required
    - `scenarioTypeVersion` string, required

## Acknowledgement `2XX`

OK

---

[API](https://skmtc.net/callr/apis/callr-rest-api-v2-0.md) · [All operations](https://skmtc.net/callr/apis/callr-rest-api-v2-0/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/callr/callr-rest-api-v2-0/versions/76d36d004a8f/schema)