- Created by Documentation, last modified on Oct 05, 2018
disable_authentication_provider
disable_failing_authentication_providers
enable_authentication_provider
get_available_authentication_providers
get_provider_client_configurations
get_provider_configuration_fields
get_provider_display_configurations
get_users_authn_linked_accounts
set_provider_client_configurations
set_provider_display_configurations
twofactorauth_generate_tfa_config
twofactorauth_get_user_configs
cpgreylist_is_server_netblock_trusted
cpgreylist_list_entries_for_common_mail_provider
cpgreylist_load_common_mail_providers_config
cpgreylist_save_common_mail_providers_config
cpgreylist_trust_entries_for_common_mail_provider
cpgreylist_untrust_entries_for_common_mail_provider
create_cpgreylist_trusted_host
delete_cpgreylist_trusted_host
Description
This function lists the status of a cPanel's mail account's mailboxes.
Important:
MailReceive
role, the system disables this function. For more information, read our How to Use Server Profiles documentation.Examples
https://hostname.example.com:2087/cpsess##########/json-api/get_mailbox_status_list?api.version=1&account=user@example.com
https://hostname.example.com:2087/cpsess##########/xml-api/get_mailbox_status_list?api.version=1&account=user@example.com
whmapi1 get_mailbox_status_list account=user@example.com
Notes:
- You must URI-encode values.
- For more information and additional output options, read our Guide to WHM API 1 documentation or run the
whmapi1 --help
command. If you run CloudLinux™, you must use the full path of the
whmapi1
command:/usr/local/cpanel/bin/whmapi1
{ "metadata":{ "command":"get_mailbox_status_list", "version":1, "result":1, "reason":"OK" }, "data":{ "mailboxes":[ { "guid":"1234560f0c58d158c92a000044f0d230", "messages":"0", "mailbox":"INBOX.marla_singer@example_com", "vsize":"0" }, { "guid":"11234560f0c58d158c92a000044f0d23", "messages":"0", "mailbox":"INBOX.angel_face@example_com", "vsize":"0" }, { "guid":"111234560f0c58d158c92a000044f0d2", "messages":"0", "mailbox":"INBOX.tyler_durden@example_com", "vsize":"0" }, { "guid":"1111234560f0c58d158c92a000044f0d", "messages":"0", "mailbox":"INBOX.Trash", "vsize":"0" }, { "guid":"11111234560f0c58d158c92a000044f0", "messages":"0", "mailbox":"INBOX.narrator@example_com", "vsize":"0" }, { "guid":"111111234560f0c58d158c92a000044f", "messages":"0", "mailbox":"INBOX", "vsize":"0" }, { "guid":"1111111234560f0c58d158c92a000004", "messages":"0", "mailbox":"INBOX.Sent", "vsize":"0" }, { "guid":"11111111234560f0c58d158c92a00000", "messages":"0", "mailbox":"INBOX.Drafts", "vsize":"0" }, { "guid":"111111111234560f0c58d158c92a0000", "messages":"0", "mailbox":"INBOX.robert_paulsen@example_com", "vsize":"0" } ] } }
<metadata> <command>get_mailbox_status_list</command> <version>1</version> <result>1</result> <reason>OK</reason> </metadata> <data> <mailboxes> <guid>1234560f0c58d158c92a000044f0d230</guid> <messages>0</messages> <mailbox>INBOX.marla_singer@example_com</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>11234560f0c58d158c92a000044f0d23</guid> <messages>0</messages> <mailbox>INBOX.angel_face@example_com</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>111234560f0c58d158c92a000044f0d2</guid> <messages>0</messages> <mailbox>INBOX.tyler_durden@example_com</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>1111234560f0c58d158c92a000044f0d</guid> <messages>0</messages> <mailbox>INBOX.Trash</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>11111234560f0c58d158c92a000044f0</guid> <messages>0</messages> <mailbox>INBOX.narrator@example_com</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>111111234560f0c58d158c92a000044f</guid> <messages>0</messages> <mailbox>INBOX</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>1111111234560f0c58d158c92a000004</guid> <messages>0</messages> <mailbox>INBOX.Sent</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>11111111234560f0c58d158c92a00000</guid> <messages>0</messages> <mailbox>INBOX.Drafts</mailbox> <vsize>0</vsize> </mailboxes> <mailboxes> <guid>111111111234560f0c58d158c92a0000</guid> <messages>0</messages> <mailbox>INBOX.robert_paulsen@example_com</mailbox> <vsize>0</vsize> </mailboxes> </data>
Note:
Parameters
Parameter | Type | Description | Possible values | Example |
---|---|---|---|---|
account | string | Required The email account's name. |
|
|
Returns
Return | Type | Description | Possible values | Example |
---|---|---|---|---|
mailboxes | array | An array that contains information about the mailbox's contents. Note: The mailbox name is the return's name. | This array contains the guid , mailbox , messages , and vsize returns. | |
| string | The mailbox GUID. This value returns in the | A valid alpha-numeric 32-byte GUID that the account owns. | 1234560f0c58d158c92a000044f0d230 |
| string | The mailbox name. This value returns in the mailboxes array. | A valid mailbox folder on the server that the user owns. | INBOX.marla_singer@example_com |
| integer | The total number of messages in the mailbox. The function returns this value in the | A valid integer. | 0 |
| integer | The total virtual size of the mailbox's contents, computed with CRLF line terminators. The function returns this value in the | A valid integer that represents the virtual size of the mailbox, in bytes. | 0 |
Function information
API Version:
Available in:
WHM 64+
Methods:
GET, POST
Required Parameters:
Return Formats:
About WHM API 1
WHM API 1 performs functions and accesses data in WHM.
Notes:
- Some functions and parameters may require that you authenticate as the
root
user. - You must use the appropriate WHM ports (
2086
or2087
) to call WHM API functions.
Find a function
Related functions
-
Page:WHM API 1 Functions - get_mailbox_status_list — This function lists the status of a cPanel's mail account's mailboxes.
-
Page:WHM API 1 Sections - Server Administration — Server administration functions allow you to manage your server's services and functions.
-
Page:WHM API 1 Functions - configurebackgroundprocesskiller — This function configures the server's background process killer.
-
Page:WHM API 1 Functions - get_all_contact_importances — This function lists the importance of all application events in WHM's Contact Manager interface (Home >> Server Contacts >> Contact Manager).
-
Page:WHM API 1 Functions - get_appconfig_application_list — This function lists registered AppConfig applications.