The hangupCause parameter is used to inform you why an outbound call did not go through. This is one of the parameters sent to your callback Url and events Url (if provided). Here's a sample of what that looks like.
callSessionState=NotAnswered&hangupCause=USER_BUSY&direction=Outbound&callerCountryCode=254&durationInSeconds=0&amount=0&callerNumber=%2B254705336634&destinationNumber=%2B254711082369&status=NotAnswered&sessionId=ATVId_b1782591735cb0a658b2c0da6cdb2abf&callStartTime=None&isActive=0¤cyCode=KES
Below are the situations where this might happen.
If the call goes unanswered
If the call is rejected
If the recipient's phone is off or unreachable
If you need any more clarification reach us on voice@africastalking.com.