Skip to end of metadata
Go to start of metadata


The body of the API's HTTP response is XML describing either the errors encountered, or the result of a successful request.

All response bodies contain a 'response' tag with a 'processed_date' attribute. The results are contained within the 'response' tag. The 'processed_date' attribute contains the date that the request was processed by the server, in ISO 8601 format.

An error response body might look like this:

You can see that the XML above contains a list of errors - in this case only one. The error codes will be specific to the nature of the error. In this case we attempted to access a resource that doesn't exist. So the error code is the same as the response header status code 404, meaning 'resource not found'. However error codes are sometimes specific to the resource being called. For example, the sms resource might return errors like this:

In this case, no data was passed to the resource except for the username and password. The errors therefore describe problems with the data passed, like the 'message' parameter is missing.
The error codes below 200, and all error messages, are specific to the resource and are detailed further below.


The DTD of the error response is included below for your reference.

  • No labels