Error codes

Every error carries a code, and more_info links to its page here. Five-digit codes are about the request or the account; six-digit codes (700000-799999) are about your line, its calls and texts, TwiML, Media Streams and webhooks. A code is never renumbered or reused.

Request and account errors

Code	HTTP	Where you see it	Meaning
20003	401	HTTP	authentication failed
20005	401	HTTP	the account isn't active
20403	403	HTTP	this key can't do that
20404	404	HTTP	not found (also: a call that isn't on this line)
20429	429	HTTP	too many requests
21205	400	HTTP	the Url isn't a valid URL
21211	400	HTTP	invalid To number
21212	400	HTTP	invalid From number
21220	400	HTTP	the call isn't in a state that allows this (it has ended)
21602	400	HTTP	a message body is required
21606	400	HTTP	From isn't a line on this account
21617	400	HTTP	the body is over 1600 characters

Line, call, text and webhook errors

Code	HTTP	Where you see it	Meaning
700001	409	HTTP	line busy: one call at a time per dongle
700002	409	HTTP	the line can't call now
700003	400	HTTP	this number type isn't allowed on this line (premium, short code, international)
700004	400	HTTP	emergency numbers can't be called through the API: call 000 from a phone
700005	400	HTTP	this line has no calling dongle (texts only)
700006	429	HTTP	this line's call limit is reached
700007	503	HTTP	the dongle is busy for a moment: try again
700008	400	HTTP	a call parameter isn't supported in v1
700009	400	HTTP	a number parameter isn't supported in v1
700011	400	HTTP	exactly one of Url or Twiml is required
700012	400	HTTP	a parameter value is invalid or out of range
710001	429	HTTP	this line's text limit is reached
710002	400	HTTP / StatusCallback	the text can't be sent
710003	400	HTTP	a message parameter isn't supported in v1
710004	400	HTTP	only Body="" (redaction) is allowed when updating a message
711001	400	HTTP	MMS (MediaUrl) isn't supported in v1
720001	400	HTTP (Twiml=) / StatusCallback	a TwiML verb or attribute isn't supported in v1
720002	400	HTTP (Twiml=) / StatusCallback	the TwiML is invalid
720003	-	StatusCallback	the call's TwiML budget was used up (fetches, verbs or time)
730001	-	StatusCallback	the Media Streams URL couldn't be connected
730002	-	the stream closes + StatusCallback	an invalid or oversized stream message
730003	-	the stream closes + StatusCallback	the stream was idle for 30 s
740001	400	HTTP	the SIP password doesn't meet the rules
740002	429	HTTP	too many SIP password changes on this line
790001	400	HTTP (when set) / StatusCallback (at use)	that URL can't be fetched (a refused address or scheme)
790002	-	StatusCallback	the webhook timed out
790003	-	StatusCallback	the webhook answered with an error status
790004	-	StatusCallback	the fetched document or audio was too large
790005	400	HTTP	an invalid list filter
790006	413	HTTP	the request body is over 64 KiB
799999	500	HTTP / StatusCallback	an internal error