JSON API » mailboxes » mailboxes/get

Gets the fields of a mailbox.

Input parameters

Requires authentication and the administrator, residential, or user role privileges.

NameTypeDescriptionRequiredDefault value
auth_usernameStringAuthentication username.Yes
auth_passwordStringAuthentication password.Yes
mailboxStringMailbox to get.Yes
customerIntegerID of customer owning mailbox.NoCustomer of authentication user.

Responses

CodeDescription
200Success.
401The authentication details provided are invalid.
402Your role does not allow this.
404The mailbox does not exist, or you do not have permission to view it.

Data returned

Fields of mailbox.

Example: With required parameters

http://enswitch.example.com/api/json/mailboxes/get/?auth_username=user;auth_password=password;mailbox=1234

{ "responses":[ { "code":"200", "key":"", "message":"OK" } ], "data":{ "mailbox":"1234", "customer":2, ... } }

Change history

VersionChanges
3.13Function added.