Error codes
The API defines error codes to convey information about possible issues. Below is a list of all error codes as well as possible causes for the error code to appear.
Errors
- The provided list of capabilities contains invalid capabilities for the phone number
- The capabilities for the phone number are missing
- The argument passed is invalid
- An attempt was made to cancel an in-progress call
- An attempt was made to update a completed call
- An attempt was made to update a conference or conference participant for a completed conference
- An attempt was made to cancel an in-progress or finished fax
- A required argument was left blank
- An attempt was made to redact a message that is still in-progress
- Your CXML document failed to parse. There could be a leading space, a missing or unclosed element, or incorrect attribute
- The attribute in sendDigits includes an invalid character. It may only contain '0123456789ABCD*#wW'
- The provided conference attributes are invalid
- The required conference attributes are missing
- The participant to be coached is not in the provided conference
- The friendly name is missing
- The friendly name must be between 1 and 64 characters long
- The friendly name is invalid
- An attempt was made to delete a call that is not finished
- An attempt was made to delete a fax that is not finished
- An attempt was made to delete a message that is in-progress
- An attempt was made to delete media for a message that is in-progress
- The passed document is not a valid CXML document. The CXML document is missing a content type header or contains an invalid parameter/value
- The provided Timeout parameter was invalid
- The provided Timeout parameter was not a positive whole integer
-
The Method parameter provided was not GET or POST
-
The passed mode was not valid for the phone number
- The From number provided was not a purchased or verified number in your project
- The From number provided was not a purchased number in your project
- An outbound message was attempted where the From number provided was a verified caller ID
- The From number provided was not E164 while dialing to a phone number
- The From number provided must be a E164 number, caller ID string, or SIP URI
- The From number provided must be a E164 number or client identifier
- The From number provided has invalid format
- The account limitations for this feature have been exceeded
- The 'To' phone number is not a verified caller ID and the account is in Trial mode
- The 'To' phone number is not a verified caller ID as required for Platform Free Trial messaging
- The call cannot be redirected if it is not in-progress
- A stream cannot be started for a call or conference in the current state
- A recording cannot be started for a call that is not in-progress
- The phone number is not a valid SMS or MMS capable number
- The phone number is not a voice capable number
- The phone number is not a fax capable number
- The format of the 'To' or 'From' is invalid
- The 'From' number is missing
- The 'To' number has invalid format
- The 'To' number is missing
- The 'From' number has exceeded the maximum number of queued calls, messages, or faxes for the account
- The number group provided does not have a phone number in the group capable of the operation you are attempting
- The account balance is insufficient to send the message
- The account balance is insufficient for the operation you are attempting
- The message was attempted but the destination handset is not reachable
- The message was attempted but the destination handset is unknown
- The message could not be routed to the destination handset
- The message was flagged as a carrier violation
- The message was filtered due to disallowed content
- The message failed due to an unknown upstream error
- The max price was exceeded by the cost of the message
- The max price was exceeded by the cost of the call
- The US A2P 10DLC messaging rate limits were exceeded
- The websocket URL provided for the stream is invalid
- The websocket URL schema is not WSS
- The websocket URL has a trailing whitespace
- The websocket URL has an embedded whitespace
- The PFT Campaign daily message cap has been met
- The sole proprietor campaign daily message cap has been met
- The redacted message body must be empty
- An attempt to redact the message by passing a different body was made
- The URL returned an HTTP redirect
- The URL exceeded the max amount of HTTP redirects
- There was an internal failure while attempting to process the media
- The PageToken provided is invalid or missing
- A PageToken must be included if your Page value is larger than 0
- The wildcard is invalid while searching for available numbers
- The format for the argument provided is invalid
- The supplied parameter is unsupported
- The supplied parameter can only be used in combination with InRegion
- The E911 address cannot be set on creation - update the record after it is created
- The specified capability could not be restricted on purchase
Warnings
- The Conference noun cannot be mixed with Number nouns
- The Conference noun can only be used once inside a Dial verb
- The Dial noun has an invalid nested element
- The only valid nested element for Dial is Number
- The Dial noun includes too many nouns
- The Refer noun has an invalid nested element
- No verbs can be nested within Refer, and Refer cannot be nested in any other verbs
- The phone number in Dial is not formatted correctly. It must be E164
- The phone number in Dial is missing
- You are attempting to Dial something that is not a phone number
- There was an invalid Verb provided in the CXML executed by the waitUrl, holdUrl, or announceUrl
- The executed CXML contains Dial, Gather, Hangup, or Record - these are not allowed
- The SIP URI provided for Dial -> SIP is missing
- The SIP URI provided for Dial -> SIP is not a public IP address
- The SIP URI provided for Dial -> SIP does not resolve
- The URL provided for Play does not return audio
- The URL provided for Play has an invalid content type