Skip to main content

Appendix E: Hangup Cause Code Table

FreeSWITCH ends every channel with a hangup cause. You see its name in the hangup_cause channel variable, in the Hangup-Cause event header, in CDRs, and in the log. To diagnose a call that failed during setup, see Chapter 42: Call-Setup Failures.

Codes up to 127 come from ITU-T Q.850. Higher codes are FreeSWITCH additions for conditions the standard does not cover.

The SIP column is the response mod_sofia sends for each cause, from hangup_cause_to_sip() in mod_sofia.c. An asterisk marks causes with no explicit mapping, which use that function's default of 480 when a response is sent at all. A call that has already been answered ends with a BYE, not a response code. The reverse direction, from a received SIP response to a cause, uses a separate mapping, so the two do not always match.

CauseCodeSIPMeaning
NONE0480*No cause recorded
UNALLOCATED_NUMBER1404Unallocated (unassigned) number
NO_ROUTE_TRANSIT_NET2404No route to specified transit network (national use)
NO_ROUTE_DESTINATION3404No route to destination
CHANNEL_UNACCEPTABLE6480*Channel unacceptable
CALL_AWARDED_DELIVERED7480*Call awarded, being delivered in an established channel
NORMAL_CLEARING16480*Normal call clearing
USER_BUSY17486User busy
NO_USER_RESPONSE18408No user responding
NO_ANSWER19480No answer from user (user alerted)
SUBSCRIBER_ABSENT20480Subscriber absent
CALL_REJECTED21603Call rejected
NUMBER_CHANGED22410Number changed
REDIRECTION_TO_NEW_DESTINATION23410Redirected to a new destination
EXCHANGE_ROUTING_ERROR25483Exchange routing error
DESTINATION_OUT_OF_ORDER27502Destination out of order
INVALID_NUMBER_FORMAT28484Invalid number format (address incomplete)
FACILITY_REJECTED29501Facilities rejected
RESPONSE_TO_STATUS_ENQUIRY30480*Response to STATUS INQUIRY
NORMAL_UNSPECIFIED31480Normal, unspecified
NORMAL_CIRCUIT_CONGESTION34503No circuit/channel available
NETWORK_OUT_OF_ORDER38503Network out of order
NORMAL_TEMPORARY_FAILURE41503Temporary failure
SWITCH_CONGESTION42503Switching equipment congestion
ACCESS_INFO_DISCARDED43480*Access information discarded
REQUESTED_CHAN_UNAVAIL44503Requested circuit/channel not available
PRE_EMPTED45480*Preempted
FACILITY_NOT_SUBSCRIBED50480*Requested facility not subscribed
OUTGOING_CALL_BARRED52403Outgoing calls barred
INCOMING_CALL_BARRED54403Incoming calls barred
BEARERCAPABILITY_NOTAUTH57403Bearer capability not authorized
BEARERCAPABILITY_NOTAVAIL58503Bearer capability not presently available
SERVICE_UNAVAILABLE63480*Service or option not available, unspecified
BEARERCAPABILITY_NOTIMPL65488Bearer capability not implemented
CHAN_NOT_IMPLEMENTED66480*Channel type not implemented
FACILITY_NOT_IMPLEMENTED69501Requested facility not implemented
SERVICE_NOT_IMPLEMENTED79501Service or option not implemented, unspecified
INVALID_CALL_REFERENCE81480*Invalid call reference value
INCOMPATIBLE_DESTINATION88488Incompatible destination
INVALID_MSG_UNSPECIFIED95480*Invalid message, unspecified
MANDATORY_IE_MISSING96480*Mandatory information element is missing
MESSAGE_TYPE_NONEXIST97480*Message type non-existent or not implemented
WRONG_MESSAGE98480*Message not compatible with call state or message type non-existent or not implemented
IE_NONEXIST99480*Information element / parameter non-existent or not implemented
INVALID_IE_CONTENTS100480*Invalid information element contents
WRONG_CALL_STATE101480*Message not compatible with call state
RECOVERY_ON_TIMER_EXPIRE102504Recovery on timer expiry
MANDATORY_IE_LENGTH_ERROR103480*Parameter non-existent or not implemented - passed on (national use)
PROTOCOL_ERROR111480*Protocol error, unspecified
INTERWORKING127480*Interworking, unspecified
SUCCESS142480*The result originate reports when a leg answers. Not normally seen as a channel hangup cause
ORIGINATOR_CANCEL487487The caller hung up before the call was answered
CRASH700480*FreeSWITCH internal cause
SYSTEM_SHUTDOWN701480*FreeSWITCH is shutting down
LOSE_RACE702480*Another leg of a simultaneous dial answered first
MANAGER_REQUEST703480*Hung up by an API or management request
BLIND_TRANSFER800480*The channel ended after a blind transfer
ATTENDED_TRANSFER801480*The channel ended after an attended transfer
ALLOTTED_TIMEOUT802480*The call exceeded its allotted time
USER_CHALLENGE803480*FreeSWITCH answered the INVITE with a SIP 401 challenge, for example from the respond application, or voicemail PIN authentication failed in auth_only mode
MEDIA_TIMEOUT804480*No media arrived before the RTP timeout
PICKED_OFF805480*The call was picked up by another channel
USER_NOT_REGISTERED806480*The user has no active registration
PROGRESS_TIMEOUT807480*Call progress did not arrive before the progress timeout
INVALID_GATEWAY808484The gateway named in the dial string does not exist
GATEWAY_DOWN809503The gateway is down or unreachable
INVALID_URL810484The dial string could not be parsed
INVALID_PROFILE811502The SIP profile named in the dial string does not exist
NO_PICKUP812480*A pickup/ leg dropped because every other leg of the originate ended
SRTP_READ_ERROR813480*SRTP read error
BOWOUT814480*FreeSWITCH internal cause
BUSY_EVERYWHERE815600Busy everywhere (SIP 600)
DECLINE816603Declined (SIP 603)
DOES_NOT_EXIST_ANYWHERE817604Does not exist anywhere (SIP 604)
NOT_ACCEPTABLE818606Not acceptable (SIP 606)
UNWANTED819607Unwanted call (SIP 607)
NO_IDENTITY820428STIR/SHAKEN: Identity header required
BAD_IDENTITY_INFO821429STIR/SHAKEN: bad Identity information
UNSUPPORTED_CERTIFICATE822437STIR/SHAKEN: unsupported certificate
INVALID_IDENTITY823438STIR/SHAKEN: invalid Identity header
STALE_DATE824403STIR/SHAKEN: stale date
REJECT_ALL825603Rejected