General Errors

Extended error codes for a variety of error types are listed below. Click the error code number to view detailed information on the error type, as well as suggestions for avoiding or resolving the error.


Error Code: 10000

Description: API server was unable to decode a valid HTTP request

The system received a request that didn’t follow the HTTP protocol. Please check the content of your request to make sure it contains a supported HTTP method (POST, GET, PUT, DELETE), a well-formed URL, and a protocol specification (HTTP/1.0 or HTTP/1.1). The request must also include a host header, an authentication header and optional headers (Content-Type, Content-Length, Accept). Note that HTTP methods are case sensitive and should be written in uppercase.

Example:

GET /calls HTTP/1.1
Host: v1.api.phone.com
Authorization: Basic :encoded credentials:
Content-Length: 200

Other HTTP headers can be included but are not used by the API server. The HTTP error code for this request will be 400.


Error Code: 10001

Description: Missing authentication header

The system received an HTTP request that did not include a recognized authentication header (Authorization). The request was likely submitted without passing credentials. Please re-submit the request with the header. The header name is case insensitive. For example, if you are using the curl command, use the -u option. The HTTP error code for this request will be 401.


Error Code: 10002

Description: Invalid authentication header

The system received an HTTP request with an Authorization header, but the authentication scheme was not set to Basic. Make sure that your client is configured to use Basic authentication. Note that the keyword Basic is case insensitive.

Example:

Authorization: Basic dXNlcjpwYXNz

For example, if you are using the curl command, use the - -basic option. The HTTP error code for this request will be 401.


Error Code: 10003

Description: Invalid authentication format

The system received an HTTP request with an Authorization header but could not decode the credentials. Please check the format of the encoded API key and password. The expected format is a string containing the API key and API password, separated by a colon (example: key:password), encoded in Base64. The HTTP error code for this request will be 401.


Error Code: 10004

Description: Invalid credentials

The system received an HTTP request with an Authorization header and was able to decode the credentials but could not validate them. Please check the API Key and API Password (see Configuring Your Application). The API key and password are both case sensitive. The HTTP error code for this request will be 401.


Error Code: 10005

Description: Invalid HTTP method

The HTTP method in your request is either invalid or not supported. The Phone.com API supports POST, GET, PUT and DELETE. The command must be in uppercase. The HTTP error code for this request will be 400.


Error Code: 10006

Description: Invalid API version requested

The request does not specify a supported API version. The version must be specified via the hostname in the API URL (for example, v1.api.phone.com), which must appear in the Host: field of the HTTP request. The HTTP error code for this request will be 400.


Error Code: 10007

Description: Invalid format specified in header

The HTTP request contains a format specification in the Content-Type header but it is not recognized. The Phone.com API supports the JSON data format for describing resources.

The system recognizes the following values for the Content-Type header:

  • text/json and application/json, if the JSON data is passed as raw content in the body
  • application/x-www-form-urlencoded, if the JSON data is passed as a POST variable
  • multipart/form-data, for requests supporting multipart uploads (for example, as with greetings)

The Content-Type header is optional, but if present, it must use a supported value. The HTTP error code for this request will be 400.


Error Code: 10008

Description: Invalid format specified as argument

The HTTP request contained a format specification as a URL argument (format=<value>) that was not recognized. The only format supported is JSON. Note that this field is not required, since JSON is assumed, but if the format argument is included, the value must be json. The HTTP response code will be 400.


Error Code: 10009

Description: Deprecated


Error Code: 10010

Description: Request too large

The HTTP request is too large. The maximum size supported by the Phone.com API is 20 MB. The HTTP response code will be 400.


Error Code: 10011

Description: Deprecated


Error Code: 10012

Description: Internal error code


Error Code: 10013

Description: Unexpected body format

The system detected a request using application/x-www-form-urlencoded as the Content-Type but couldn’t process the body of the request. When passing the JSON data structure using a form upload format, the body must contain a key-value pair, where the key is json and the value is the URL-encoded JSON object. The HTTP response code will be 400.


Error Code: 10014

Description: Unexpected resource format

The API resource specified in the URL does not match the format of any resource supported by the Phone.com API (for example, /menus or /sms). Please check the resource used in your request against the list of valid resources. The HTTP response code will be 400.


Error Code: 10015

Description: Internal error code

This is an internal error code. If this error persists, please contact Phone.com API Support. The HTTP response code will be 500.


Error Code: 10016

Description: Insufficient account balance

The request targets a function that includes a billable operation (for example, placing a phone call or sending an SMS message) but your account balance does not have sufficient funds. Please review the status of your account balance. The HTTP response code will be 403.


Error Code: 10017

Description: Unauthorized access. Account limits reached.

You have exceeded the usage limits for your account. Please contact Phone.com API Support. The HTTP response code will be 403.


Error Code: 10018

Description: Internal error code

This is an internal error code. If this error persists, please contact Phone.com API Support. The HTTP response code will be 500.


Error Code: 10019

Description: Deprecated


Error Code: 10020

Description: Problem with JSON format

The system could not parse the JSON object in the request. Review the syntax of the object to ensure that it matches the JSON specification. The HTTP response code will be 400.


Error Code: 10021

Description: POST method applied to an object

The method used in the HTTP request is not applicable to this resource. The Phone.com API supports POST requests to a collection, not to individual objects. The HTTP response code will be 400.


Error Code: 10022

Description: PUT method applied to a collection

The method used in the HTTP request is not applicable to this resource. The Phone.com API supports PUT requests to an individual object only, not to a collection. The HTTP response code will be 400.


Error Code: 10023

Description: Deprecated


Error Code: 10024

Description: Body in a POST or PUT request is missing

The body in a POST or PUT request is missing, The HTTP response code will be 400.


Error Code: 10025

Description: Invalid UTF-8 string

Applies to requests sent in UTF-8 encoding. The system could not validate the encoding of the object. Check to ensure that you have used valid UTF-8. The HTTP response code will be 400.


Error Code: 10026

Description: Invalid Latin1 (ISO 8859-1) string

Applies to requests sent in Latin1 encoding. The system could not validate the encoding of the object. Check to ensure that you have used valid Latin1. The HTTP response code will be 400.


Error Code: 10027

Description: Invalid encoding

The request included an encoding format not supported by the Phone.com API. Encoding is set via the charset field in the Content-Type header. Valid values are utf-8 and iso-8859-1. The HTTP response code will be 400.


Error Code: 10028

Description: /calls service error. To be added.


Error Code: 10029

Description: /calls service error. To be added.


Error Code: 10030

Description: Unsupported characters in object

The system does not accept requests containing the characters <, >, & or HTML-like tags.


Error Code: 10031

Description: Internal error code

This is an internal error code. If this error persists, please contact Phone.com API Support. The HTTP response code will be 500.


Error Code: 10032

Description: Internal error code

This is an internal error code. If this error persists, please contact Phone.com API Support. The HTTP response code will be 500.


Error Code: 10033

Description: Invalid basic authentication format. Multiple credentials are unsupported.

The system received an HTTP request with an Authorization header, but the authentication value contained duplicated Basic authorization credentials. Make sure that your client is configured to send one set of Basic authentication credentials. Example: Authorization: Basic dXNlcjpwYXNz

The HTTP error code for this request will be 401.


Error Code: 10034

Description: Invalid format specified in header

The HTTP request includes a format specification in the Accept header that is not supported by the Phone.com API. Our system supports JSON for describing resources, and accepts the following format values in the Accept header: text/json, application/json and text/*. Including the Accept header is optional, but if present, it must specify a supported value.

The HTTP error code for this request will be 400.


Error Code: 10035

Description: Chunked transfer encoding isn’t supported at this time.

At this time we do not support Chunked transfer encoding. If you feel you should not have received this error, please contact Phone.com API Support.

The HTTP error code for this request will be 400.


Error Code: 20001

Description: Error processing job

The event has been logged. The system was unable to locate the service session. The HTTP response code for this request will be 500.


Error Code: 20002

Description: Error processing job

The event has been logged. The system is missing the service destination. The HTTP response code for this request will be 500.


Error Code: 40000

Description: Syntax error in document

The service was unable to understand the syntax of the document. Please check the syntax of the document and resend. The HTTP response code for this request will be 400.


Error Code: 40001

Description: Could not decode request

The service was unable to decode the request. Please check the encoding scheme of the request and resend. The HTTP response code for this request will be 400.

Learn More: