Core

Error codes

View as Markdown

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

4000
Error
  • The provided list of capabilities contains invalid capabilities for the phone number
  • The capabilities for the phone number are missing
4001
Error
  • The fee for the operation you are trying to perform costs more than the available balance
10000
Error
  • 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
10001
Error
  • The operation attempted is not enabled on the Space
10003
Error
  • The permissions passed for the API token contain invalid selections
10004
Error
  • The subproject ID passed does not belong to the project used to authenticate the request
11100
Error
  • The URL passed to update the queue member is invalid
11200
Error
  • The attempt to deliver a webhook to your server timed out
11210
Error
  • DNS resolution failure due to bad hostname
11215
Error
  • Redirected too many times
11217
Error
  • The attempt to deliver a webhook to your server responded with a 4xx or 5xx status code
11220
Error
  • An error occurred during the SSL/TLS handshake
11251
Error
  • There was a fatal protocol violation
11300
Error
  • HTTP version not supported
11750
Error
  • The provided response body is too large
11751
Error
  • The total size of the media message request exceeds the maximum size limit
12100
Error
  • Your CXML document failed to parse. There could be a leading space, a missing or unclosed element, or incorrect attribute
12300
Error
  • The content type of the provided URL is invalid
13221
Error
  • The HTTP method attribute is invalid - it can only be ‘GET’ or ‘POST’
13222
Error
  • The attribute in sendDigits includes an invalid character. It may only contain ‘0123456789ABCD*#wW’
13621
Error
  • The provided event is not a valid recording callback event
13699
Error
  • The provided trim value for the recording is invalid
16002
Error
  • The provided conference attributes are invalid
  • The required conference attributes are missing
  • The participant to be coached is not in the provided conference
20001
Error
  • An unknown error occurred
20002
Error
  • The friendly name is missing
  • The friendly name must be between 1 and 64 characters long
  • The friendly name is invalid
20003
Error
  • There was an authentication error or API access is blocked for this feature
20009
Error
  • 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
20010
Error
  • The action you are attempting to perform is disabled for the account
20404
Error
  • The resource you are trying to access does not exist
20422
Error
  • The passed document is not a valid CXML document. The CXML document is missing a content type header or contains an invalid parameter/value
20429
Error
  • There were too many requests or throughput was exceeded
20504
Error
  • An internal error occurred
21205
Error
  • A phone call was attempted without a CXML URL or ApplicationSid
21208
Error
  • The provided Timeout parameter was invalid
  • The provided Timeout parameter was not a positive whole integer
21209
Error

  • The Method parameter provided was not GET or POST

  • The passed mode was not valid for the phone number

21210
Error
  • 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
21211
Error
  • The ‘To’ number provided was missing
  • The ‘To’ number provided has an invalid format
21212
Error
  • The From number provided was not E164 while dialing to a phone number
  • The From number provided must be an E164 number, caller ID string, or SIP URI
  • The From number provided must be an E164 number or client identifier
  • The From number provided has invalid format
21213
Error
  • An outbound call was attempted without a From number
21217
Error
  • The To phone number provided does not appear to be valid
21218
Error
  • The provided ApplicationSid is invalid
  • The provided ApplicationSid does not exist
21219
Error
  • 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
21220
Error
  • 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
21234
Error
  • The AMD parameters provided are not valid
21262
Error
  • The AMD status callback URL is missing
21401
Error
  • The phone number you’re attempting to purchase has an invalid format
21402
Error
  • The URL is not valid
  • The URL is not a fully qualified URL
21408
Error
  • The callback URL is not set
21420
Error
  • The passed VoiceApplicationSid or SmsApplicationSid could not be found
21421
Error
  • An area code or number must be provided to purchase a number
21451
Error
  • The area code is not formatted correctly
21456
Error
  • The supplied callback URL is not valid
21475
Error
  • An attempt was made to update a conference with an invalid status
21481
Error
  • The page token supplied was invalid
21601
Error
  • 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
21602
Error
  • An attempt was made to send a message without a media URL or text body
21603
Error
  • 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
21604
Error
  • The ‘To’ number is required to send a message
21606
Error
  • The ‘To’ number provided is not a mobile number
21610
Error
  • The message was blocked by the user or sent from a blacklisted number
21611
Error
  • The ‘From’ number has exceeded the maximum number of queued calls, messages, or faxes for the account
21612
Error
  • The Media provided is not supported
21614
Error
  • The ‘To’ number is not a valid mobile number
21617
Error
  • The concatenated message body exceeds the allowed character limit
21620
Error
  • The media URL(s) provided is/was invalid
  • The URL must be HTTP or HTTPS
21623
Error
  • The number of media files exceeds the allowed limit
21624
Error
  • The validity period provided is invalid
21626
Error
  • The callback event is not valid
21628
Error
  • The E911 address provided is invalid for this phone number
21701
Error
  • The number group provided is invalid or unrecognized
21703
Error
  • The number group provided does not have a phone number in the group capable of the operation you are attempting
21705
Error
  • The message was attempted without a From number or Number Group
21717
Error
  • The ‘From’ number must belong to an active campaign
22109
Error
  • The E911 address ID provided is not valid
22121
Error
  • This number was purchased too recently to release
30001
Error
  • The validity period for the message was exceeded
30002
Error
  • The account balance is insufficient to send the message
  • The account balance is insufficient for the operation you are attempting
30003
Error
  • The message was attempted but the destination handset is not reachable
30004
Error
  • The message was attempted but blocked by the destination carrier
30005
Error
  • The message was attempted but the destination handset is unknown
30006
Error
  • The message could not be routed to the destination handset
30007
Error
  • The message was flagged as a carrier violation
  • The message was filtered due to disallowed content
30008
Error
  • The message failed due to an unknown upstream error
30009
Error
  • The message’s validity period has expired at the carrier
30010
Error
  • The max price was exceeded by the cost of the message
  • The max price was exceeded by the cost of the call
30022
Error
  • The US A2P 10DLC messaging rate limits were exceeded
30027
Error
  • The US A2P 10DLC T-Mobile Daily Message Limit was reached
31003
Error
  • The request resulted in a connection timeout
31922
Error
  • 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
32009
Error
  • The SIP domain dialed is not a registered endpoint
35125
Error
  • The PFT Campaign daily message cap has been met
  • The sole proprietor campaign daily message cap has been met
50509
Error
  • The redacted message body must be empty
  • An attempt to redact the message by passing a different body was made
53603
Error
  • 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
54453
Error
  • The PageToken provided is invalid or missing
  • A PageToken must be included if your Page value is larger than 0
54454
Error
  • The page size provided is invalid
63011
Error
  • The message could not be delivered to the carrier
63019
Error
  • The media could not be downloaded
90000
Error
  • 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

13000
Warning
  • The Conference noun cannot be mixed with Number nouns
  • The Conference noun can only be used once inside a Dial verb
13215
Warning
  • 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
13223
Warning
  • 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
13238
Warning
  • 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
13243
Warning
  • The provided SIP URI is formatted incorrectly
13254
Warning
  • 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
13420
Warning
  • The URL provided for Play does not return audio
  • The URL provided for Play has an invalid content type
13750
Warning
  • The verb provided is not currently supported by the API version or your Space
13801
Warning
  • The Refer verb was used on a non SIP call leg
14204
Warning
  • The queue name is too short
  • The queue is missing in the attempt to Enqueue
21201
Warning
  • The outbound phone call request was missing a ‘To’ number
21455
Warning
  • The URL given to Play is not valid
32110
Warning
  • The SIP URI provided is invalid
  • The Refer verb contains an invalid SIP URI
53404
Warning
  • The supplied codecs are unsupported or invalid