/mcpDescription Request URI Returns an Address resource that lists all of the matched names (up to a maximum of 100). GET /mailbox/addresses?name=<full or partial name> The name can be a whole name, or the beginning of the first name, last name, display name, or alias. The name value in the URI will match distribution lists, personal distribution lists, contacts, and users. For example, when searching for the user "Alexander Bell," the name could be any of the following: name=abell name=alexander name=alex name=bell name=bel name=alexander be name=alex be Error Handling When errors are encountered on the server, the CUMI API adheres to the standard REST practice of using the closest HTTP code available. It also follows the recommendation in "RESTful Web Services," and returns an error document that is human readable (and also program readable). The approach is to return codes in descending order: first the HTTP code, then the relevant VMWS error if possible, and finally the original error code and message. We generally have two levels of errors in this particular case, but the errors will be a general list to provide a more extensible mechanism. For example: 403 Forbidden Content-Type: application/xml Date: Fri, 10 Nov 2008 20:04:45 GMT Server: UnityConnection Transfer-Encoding: chunked <?xml version="1.0" encoding="UTF-8"?> <Error> <Code>E_VMWS_MSG_MAILBOX_FULL</Code> <Message>Destination mailbox is full or send quota was exceeded.</Message> <Code>0x80046408</Code> <Message>E_CML_SEND_QUOTA_EXCEEDED</Message></Error> The VMWS error codes are intended to make it easier for Cannonball and Midlet clients to cut over to this interface. In addition, having a code between HTTP and the lowest-level component error code is useful. New VMWS errors that do not apply to the SOAP interface are added in the form "E_VM{}REST_<new-error>". Here's the XSD snippet for a RestError: Cisco Unity Connection Messaging Interface (CUMI) API 18 Cisco Unity Connection Messaging Interface (CUMI) API -- Using the CUMI API for Sending Messages Error Handling