GET api/v1.0/Messaging/GetInboxMessages?firstRecord={firstRecord}&maxRecords={maxRecords}

Retrieves all Inbox Messages for the Current User.

Request Information

URI Parameters

Name	Description	Type	Additional information
firstRecord		integer	Default value is 0
maxRecords		integer	Default value is 50

Body Parameters

None.

Response Information

Resource Description

List of Mailbox Messages.

Collection of MailboxMessage

Name	Type	Additional information
MessageKey	globally unique identifier	None.
FromContactKey	globally unique identifier	None.
SentOn	date	None.
Subject	string	None.
Message	string	None.
IsInSentBox	boolean	None.
IsRead	boolean	None.
FromFirstName	string	None.
FromLastName	string	None.
FromDisplayName	string	None.
LinkToSenderProfile	string	None.
ToContactKey	globally unique identifier	None.
ToFirstName	string	None.
ToLastName	string	None.
ToDisplayName	string	None.
LinkToRecipientProfile	string	None.
LinkToRecipientSmallImage	string	None.
LinkToRecipientLargeImage	string	None.
LinkToSenderSmallImage	string	None.
LinkToSenderLargeImage	string	None.
IsSenderCompany	boolean	None.
IsRecipientCompany	boolean	None.

Response Formats

application/json, text/json

Sample:

[
  {
    "MessageKey": "fafa7093-6df5-40e9-a65c-0b9c6761401a",
    "FromContactKey": "3d3221ba-9184-4c04-81f3-1bf95269f112",
    "SentOn": "2025-10-29T07:27:54.0627945Z",
    "Subject": "sample string 4",
    "Message": "sample string 5",
    "IsInSentBox": true,
    "IsRead": true,
    "FromFirstName": "sample string 8",
    "FromLastName": "sample string 9",
    "FromDisplayName": "sample string 10",
    "LinkToSenderProfile": "sample string 11",
    "ToContactKey": "9ba8c860-41f4-4172-843f-2f2d44c7eb17",
    "ToFirstName": "sample string 13",
    "ToLastName": "sample string 14",
    "ToDisplayName": "sample string 15",
    "LinkToRecipientProfile": "sample string 16",
    "LinkToRecipientSmallImage": "sample string 17",
    "LinkToRecipientLargeImage": "sample string 18",
    "LinkToSenderSmallImage": "sample string 19",
    "LinkToSenderLargeImage": "sample string 20",
    "IsSenderCompany": true,
    "IsRecipientCompany": true
  },
  {
    "MessageKey": "fafa7093-6df5-40e9-a65c-0b9c6761401a",
    "FromContactKey": "3d3221ba-9184-4c04-81f3-1bf95269f112",
    "SentOn": "2025-10-29T07:27:54.0627945Z",
    "Subject": "sample string 4",
    "Message": "sample string 5",
    "IsInSentBox": true,
    "IsRead": true,
    "FromFirstName": "sample string 8",
    "FromLastName": "sample string 9",
    "FromDisplayName": "sample string 10",
    "LinkToSenderProfile": "sample string 11",
    "ToContactKey": "9ba8c860-41f4-4172-843f-2f2d44c7eb17",
    "ToFirstName": "sample string 13",
    "ToLastName": "sample string 14",
    "ToDisplayName": "sample string 15",
    "LinkToRecipientProfile": "sample string 16",
    "LinkToRecipientSmallImage": "sample string 17",
    "LinkToRecipientLargeImage": "sample string 18",
    "LinkToSenderSmallImage": "sample string 19",
    "LinkToSenderLargeImage": "sample string 20",
    "IsSenderCompany": true,
    "IsRecipientCompany": true
  }
]

application/xml, text/xml

Sample:

<ArrayOfMailboxMessage xmlns:i="http://www.w3.org/2001/XMLSchema-instance" xmlns="http://schemas.datacontract.org/2004/07/HigherLogic.API.Models.Enterprise">
  <MailboxMessage>
    <FromContactKey>3d3221ba-9184-4c04-81f3-1bf95269f112</FromContactKey>
    <FromDisplayName>sample string 10</FromDisplayName>
    <FromFirstName>sample string 8</FromFirstName>
    <FromLastName>sample string 9</FromLastName>
    <IsInSentBox>true</IsInSentBox>
    <IsRead>true</IsRead>
    <IsRecipientCompany>true</IsRecipientCompany>
    <IsSenderCompany>true</IsSenderCompany>
    <LinkToRecipientLargeImage>sample string 18</LinkToRecipientLargeImage>
    <LinkToRecipientProfile>sample string 16</LinkToRecipientProfile>
    <LinkToRecipientSmallImage>sample string 17</LinkToRecipientSmallImage>
    <LinkToSenderLargeImage>sample string 20</LinkToSenderLargeImage>
    <LinkToSenderProfile>sample string 11</LinkToSenderProfile>
    <LinkToSenderSmallImage>sample string 19</LinkToSenderSmallImage>
    <Message>sample string 5</Message>
    <MessageKey>fafa7093-6df5-40e9-a65c-0b9c6761401a</MessageKey>
    <SentOn>2025-10-29T07:27:54.0627945Z</SentOn>
    <Subject>sample string 4</Subject>
    <ToContactKey>9ba8c860-41f4-4172-843f-2f2d44c7eb17</ToContactKey>
    <ToDisplayName>sample string 15</ToDisplayName>
    <ToFirstName>sample string 13</ToFirstName>
    <ToLastName>sample string 14</ToLastName>
  </MailboxMessage>
  <MailboxMessage>
    <FromContactKey>3d3221ba-9184-4c04-81f3-1bf95269f112</FromContactKey>
    <FromDisplayName>sample string 10</FromDisplayName>
    <FromFirstName>sample string 8</FromFirstName>
    <FromLastName>sample string 9</FromLastName>
    <IsInSentBox>true</IsInSentBox>
    <IsRead>true</IsRead>
    <IsRecipientCompany>true</IsRecipientCompany>
    <IsSenderCompany>true</IsSenderCompany>
    <LinkToRecipientLargeImage>sample string 18</LinkToRecipientLargeImage>
    <LinkToRecipientProfile>sample string 16</LinkToRecipientProfile>
    <LinkToRecipientSmallImage>sample string 17</LinkToRecipientSmallImage>
    <LinkToSenderLargeImage>sample string 20</LinkToSenderLargeImage>
    <LinkToSenderProfile>sample string 11</LinkToSenderProfile>
    <LinkToSenderSmallImage>sample string 19</LinkToSenderSmallImage>
    <Message>sample string 5</Message>
    <MessageKey>fafa7093-6df5-40e9-a65c-0b9c6761401a</MessageKey>
    <SentOn>2025-10-29T07:27:54.0627945Z</SentOn>
    <Subject>sample string 4</Subject>
    <ToContactKey>9ba8c860-41f4-4172-843f-2f2d44c7eb17</ToContactKey>
    <ToDisplayName>sample string 15</ToDisplayName>
    <ToFirstName>sample string 13</ToFirstName>
    <ToLastName>sample string 14</ToLastName>
  </MailboxMessage>
</ArrayOfMailboxMessage>