Introduction

Calls in Voice broadcast and Voice API can end for various reasons, such as network failures, busy users, or invalid number formats. These call failures are usually described in technical telecom terms, which can be challenging to understand.

This help document explains the common hangup causes in simple, user-friendly language.

Hangup causes

Reason	Details	Description
`success`	`connected`	This cause indicates a normal call event where the call is terminated after the conversation, with no errors on the telecom side.
`success`	`voicemail`	This cause indicates the call was sent to the voicemail, and a message was left.
`busy`	`remote-busy`	This cause indicates that the called party cannot accept another call because they are busy with another call.
`no-answer`	`timeout`	This is when the called person didn't respond to the call within a specific time limit.
`no-answer`	`unknown`	The call failed at the carrier's end for unknown reasons.
`no-answer`	`unreachable`	This cause indicates that the call could not be completed because the number is not currently allocated or assigned to anyone.
`rejected`	`invalid-from-number`	The `from` number is not allocated or deactivated.
`rejected`	`invalid-phone-number-format`	This cause indicates the destination number is not in a valid format.
`rejected`	`nvalid-phone-number-country`	This cause indicates the destination number's country is not allowed.
`rejected`	`call-blocked`	This cause indicates that Naxai blocked it.
`rejected`	`no-valid-payment-setup`	This cause indicates the payment settings are not using auto top-up for your prepaid account.
`rejected`	`invalid-account`	This causes indicates your account is blocked.