What hangup cause 21 (call rejected) means and who's rejecting it

A pile of Cause 21 codes is different from a timeout or a busy. Cause 21 is call rejected — something on the path actively refused the call rather than letting it ring. The far-end phone, the receiving carrier, or an intermediate hop said no.

VICIdial folds Cause 21 into the ADCT status, Congested Number Auto, which buckets causes 19, 21, 34 and 38 together. So a rising ADCT count with Cause 21 underneath it is the dialer telling you your calls are being turned away before anyone hears them.

Who is doing the rejecting

Active rejection at scale almost always comes down to reputation on your CID (caller ID). Carriers and handset apps score outbound numbers, and once a number is flagged as Spam Likely label, calls get refused or silently blocked. That refusal comes back as Cause 21.

flowchart LR
  A[Dialer places call] --> B[Caller ID evaluated]
  B --> C{Reputation good}
  C -->|Yes| D[Call connects]
  C -->|No| E[Carrier or handset refuses]
  E --> F[Cause 21 returned]
  F --> G[Logged in ADCT bucket]

This is the opposite of plain CONGESTION, where the carrier simply could not place the call. Cause 21 means it could have, and chose not to. The fix is about how your number is seen, not about capacity.

The reputation that drives a reject builds up over time. A number that dials clean for weeks can tip into the flagged zone after one heavy day, and once it is flagged the rejects pile up fast. That is why a Cause 21 spike often appears suddenly on a number that was fine yesterday — the score crossed a line, not the list.

What to change, in order

1. Check the reputation of the caller IDs you dial with. Run them through a spam-status lookup. A flagged number will reject no matter how clean the list is.
2. Rotate or rest worn-out caller IDs and stop over-dialing from a single number. Volume on one CID is what gets it flagged in the first place.
3. Confirm your carrier is signing calls with STIR/SHAKEN and that the attestation level is correct for the numbers you own.
4. Verify your Call attestation is A-level where it should be. B or C attestation gets downgraded by terminating carriers and pushes Cause 21 up.
5. Break the ADCT rate down by caller ID. If rejects cluster on one or two numbers, you have found the flagged ones — retire them.

Cause 21 is a relationship problem between your number and the network. You repair it on the caller-ID and attestation side, not by changing how hard you dial.

For how this code sits alongside congestion and the rest, see the troubleshooting playbook. To track which caller IDs are getting refused, read how to read the caller ID log report. If you would rather not manage attestation and CID rotation by hand, VICIfast runs the box so you are not chasing this alone → see plans and pricing.