GET api/Mail?user={user}&address={address}&objectHandle={objectHandle}&serviceHandle={serviceHandle}&domHandle={domHandle}

Returns a list of mailboxes for the specified user with optional filters

Request Information

URI Parameters

Name	Description	Type	Additional information
user	User handle	string	None.
address	Email address	string	None.
objectHandle	Mailbox object handle	string	None.
serviceHandle	Service object handle	string	None.
domHandle	Domain object handle	string	None.

Body Parameters

None.

Response Information

Resource Description

List of mailboxes on success
Collection of errors on failure
Return codes
200 - ok
401 - unauthorized
404 - not found
500 - internal server error

Collection of MailBox

Name	Description	Type	Additional information
ObjectHandle	Object handle of the mail box	string	None.
DomHandle	Object handle of the domain	string	None.
State	State after execution - completed or pending	string	None.
CreDate	Create date	date	None.
ServiceHandle		string	None.
UserType		string	None.
UserName		string	None.
UserPwd		string	None.
UserDescription		string	None.
UserMailAddress		string	None.
IsCatchAll		boolean	None.
IsRedir		boolean	None.
Forward		Collection of string	None.
Alias		Collection of string	None.
Errors		Collection of Error	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "ObjectHandle": "sample string 1",
    "DomHandle": "sample string 2",
    "State": "sample string 3",
    "CreDate": "2025-10-18T04:51:38.7056917+02:00",
    "ServiceHandle": "sample string 5",
    "UserType": "sample string 6",
    "UserName": "sample string 7",
    "UserPwd": "sample string 8",
    "UserDescription": "sample string 9",
    "UserMailAddress": "sample string 10",
    "IsCatchAll": true,
    "IsRedir": true,
    "Forward": [
      "sample string 1",
      "sample string 2"
    ],
    "Alias": [
      "sample string 1",
      "sample string 2"
    ],
    "Errors": []
  },
  {
    "ObjectHandle": "sample string 1",
    "DomHandle": "sample string 2",
    "State": "sample string 3",
    "CreDate": "2025-10-18T04:51:38.7056917+02:00",
    "ServiceHandle": "sample string 5",
    "UserType": "sample string 6",
    "UserName": "sample string 7",
    "UserPwd": "sample string 8",
    "UserDescription": "sample string 9",
    "UserMailAddress": "sample string 10",
    "IsCatchAll": true,
    "IsRedir": true,
    "Forward": [
      "sample string 1",
      "sample string 2"
    ],
    "Alias": [
      "sample string 1",
      "sample string 2"
    ],
    "Errors": []
  }
]

application/xml, text/xml

Sample:

<ArrayOfMailBox xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/Namebay.Rest.Api.Models">
  <MailBox>
    <Alias xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </Alias>
    <Errors />
    <Forward xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </Forward>
    <IsCatchAll>true</IsCatchAll>
    <IsRedir>true</IsRedir>
    <ServiceHandle>sample string 5</ServiceHandle>
    <UserDescription>sample string 9</UserDescription>
    <UserMailAddress>sample string 10</UserMailAddress>
    <UserName>sample string 7</UserName>
    <UserPwd>sample string 8</UserPwd>
    <UserType>sample string 6</UserType>
    <CreDate>2025-10-18T04:51:38.7056917+02:00</CreDate>
    <DomHandle>sample string 2</DomHandle>
    <State>sample string 3</State>
  </MailBox>
  <MailBox>
    <Alias xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </Alias>
    <Errors />
    <Forward xmlns:d3p1="http://schemas.microsoft.com/2003/10/Serialization/Arrays">
      <d3p1:string>sample string 1</d3p1:string>
      <d3p1:string>sample string 2</d3p1:string>
    </Forward>
    <IsCatchAll>true</IsCatchAll>
    <IsRedir>true</IsRedir>
    <ServiceHandle>sample string 5</ServiceHandle>
    <UserDescription>sample string 9</UserDescription>
    <UserMailAddress>sample string 10</UserMailAddress>
    <UserName>sample string 7</UserName>
    <UserPwd>sample string 8</UserPwd>
    <UserType>sample string 6</UserType>
    <CreDate>2025-10-18T04:51:38.7056917+02:00</CreDate>
    <DomHandle>sample string 2</DomHandle>
    <State>sample string 3</State>
  </MailBox>
</ArrayOfMailBox>