{
  "account_id": "acct_01japd271aeatb7txrzr2xj8sg",
  "data": {
    "id": "call_01jjnn7s0zfx5tdcsxjfy93et2",
    "contact": {
      "id": "ctc_01ja88cboqffhswjx8zbak3ykk",
      "email": "dom@toretto.family",
      "first_name": "Dominic",
      "last_name": "Toretto",
      "metadata": {
        "car": "1970 Dodge Charger R/T"
      },
      "phone_number": "+18015551234"
    },
    "duration": 184,
    "initiated_at": "2025-03-31T21:01:37Z",
    "status": "completed"
  },
  "type": "call.ended"
}

The call.ended event is delivered whenever a call is completed between a Surge number you own and another phone number.

​
Common Use Cases

  • Display calls in a log in your system
  • Trigger follow-up actions
  • Update customer analytics

​
Payload Structure

{
  "account_id": "acct_01japd271aeatb7txrzr2xj8sg",
  "data": {
    "id": "call_01jjnn7s0zfx5tdcsxjfy93et2",
    "contact": {
      "id": "ctc_01ja88cboqffhswjx8zbak3ykk",
      "email": "dom@toretto.family",
      "first_name": "Dominic",
      "last_name": "Toretto",
      "metadata": {
        "car": "1970 Dodge Charger R/T"
      },
      "phone_number": "+18015551234"
    },
    "duration": 184,
    "initiated_at": "2025-03-31T21:01:37Z",
    "status": "completed"
  },
  "type": "call.ended"
}
​
account_id
string
required

The ID of the account that received the message

​
type
string
required

Always call.ended for this event

​
data
call
​
id
string

The unique identifier for the call

​
contact
contact
​
duration
integer

The duration of the call in seconds

​
initiated_at
string

ISO 8601 timestamp of when the call began

​
status
enum

The status of the call. Can be one of busy, canceled, completed, failed, missed, or no_answer