GET api/v1/systems/{systemPhoneNumber}/mailboxes/{mailboxNumber}/folders

Returns the folders of a mailbox with information on each folder given the default phone number and mailbox number.

Request Information

URI Parameters

Name	Description	Type	Additional information
systemPhoneNumber		string	Required
mailboxNumber		integer	Required

Body Parameters

None.

Response Information

Resource Description

200 status code will be returned for successful along with list folder information. 402 status code will be returned if system number is on hold. 403 status code will be returned if user does not have access to account with the system number specified or mailbox specified.

Collection of MessageFolder

Name	Description	Type	Additional information
Name		string	None.
MessageCount		integer	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "Name": "New",
    "MessageCount": 10
  },
  {
    "Name": "Sent",
    "MessageCount": 10
  }
]

application/xml, text/xml

Sample:

<ArrayOfMessageFolder xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/FreedomVoice.WebLink.Models">
  <MessageFolder>
    <MessageCount>10</MessageCount>
    <Name>New</Name>
  </MessageFolder>
  <MessageFolder>
    <MessageCount>10</MessageCount>
    <Name>Sent</Name>
  </MessageFolder>
</ArrayOfMessageFolder>