Get an inbound message
get
/crmRestApi/resources/11.13.18.05/inboundMessages/{InboundMessageId}
Request
Path Parameters
-
InboundMessageId(required): integer(int64)
The unique identifier of an inbound message.
Query Parameters
-
dependency: string
This parameter specifies dependencies which are fields that are set before and rolled back after generating the response. Generally they are used to preview the effects of an attribute change. The fields specified in this parameter are always set in the resource instance in question. When a child resource collection is requested and the parameter is set, the fields will be set in the parent resource instance before generating the resource collection payload. The value of this query parameter is a set of dependency fields. Example: dependency=ProductId=2
Format: <attr1>=<val1>,<attr2>=<value2> -
expand: string
When this parameter is provided, the specified children are included in the resource payload (instead of just a link). The value of this query parameter is "all" or "". More than one child can be specified using comma as a separator. Example: ?expand=Employees,Localizations. Nested children can also be provided following the format "Child.NestedChild" (Example: ?expand=Employees.Managers). If a nested child is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?expand=Employees.Managers" is the same as "?expand=Employees,Employees.Managers" (which will expand Employees and Managers).
-
fields: string
This parameter filters the resource fields. Only the specified fields are returned, which means that if no fields are specified, no fields are returned (useful to get only the links). If an indirect child resource is provided (Example: Employees.Managers), the missing children will be processed implicitly. For example, "?fields=Employees.Managers:Empname" is the same as "?fields=;Employees:;Employees.Managers:Empname" (which will only return the "Empname" field for Managers). the value of this query parameter is a list of resource fields. The attribute can be a direct (Example: Employees) or indirect (Example: Employees.Managers) child. It cannot be combined with expand query parameter. If both are provided, only fields will be considered.
Format: ?fields=Attribute1,Attribute2
Format for fields in child resource: ?fields=Accessor1:Attribute1,Attribute2 -
links: string
This parameter can be used to show only certain links while accessing a singular resource or a resource collection. The parameter value format is a comma-separated list of : <link_relation>
Example:
self,canonical -
onlyData: boolean
The resource item payload will be filtered in order to contain only data (no links section, for example).
Header Parameters
-
Metadata-Context: string
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version: string
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/json
Default Response
The following table describes the default response for this task.
Headers
-
Metadata-Context:
If the REST API supports runtime customizations, the shape of the service may change during runtime. The REST client may isolate itself from these changes or choose to interact with the latest version of the API by specifying this header. For example: Metadata-Context:sandbox="TrackEmployeeFeature".
-
REST-Framework-Version:
The protocol version between a REST client and service. If the client does not specify this header in the request the server will pick a default version for the API.
Root Schema : inboundMessages-item-response
Type:
Show Source
object-
AcknowledgedDate: string
(date-time)
Title:
Acknowledged DateThe date when the inbound message was acknowledged. -
Attachments: array
Attachments
Title:
AttachmentsThe attachments resource is used to create, view, update, and delete the list of files sent as attachments with the inbound messages. For example, a document with a screenshot of an error message. -
BatchId: integer
(int64)
Title:
Batch IDThe unique identifier of the batch in which the inbound message will be processed. -
Body: string
(byte)
Title:
BodyThe content of the inbound message. -
BUOrgId: integer
(int64)
Title:
Business Unit IDRead Only:trueThe unique ID of the business unit name associated to inbound email. -
ChannelId: integer
(int64)
Title:
Channel IDThe unique identifier of the channel for the inbound message. -
ChannelTypeCdMeaning: string
Title:
Channel Type ValueMaximum Length:255The display value corresponding to the channel type lookup code for the inbound email. -
ConnectionTypeCd: string
Title:
Connection Type CodeMaximum Length:30Default Value:ORA_SVC_UMSIndicates the connection type that was used to read the inbound message. -
ConnectionTypeCdMeaning: string
Title:
Connection Type ValueMaximum Length:255Indicates the display value corresponding to the connection type lookup code for the inbound message. -
ContentTypeCd: string
Title:
Content TypeMaximum Length:30The content type of the inbound message. -
ContentTypeCdMeaning: string
Title:
Content Type ValueMaximum Length:255The display value corresponding to the content type lookup code for the inbound email. -
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the inbound message. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the inbound message was created. -
DeleteFlag: boolean
Title:
Can DeleteRead Only:trueIndicates whether the inbound message can be deleted. -
FusionRecipient: string
Title:
Inbound Message AccountMaximum Length:320The account to which the service requests are forwarded. -
InboundMessageId: integer
(int64)
Title:
Inbound Message IDThe unique identifier of an inbound message. -
InboundMsgParts: array
Inbound Message Parts
Title:
Inbound Message PartsThe inbound message parts resource is used to create, view, update, and delete the list of components of an inbound message, such as From, To, CC, and Importance. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the inbound message was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the inbound message. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login of the user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
ObjectId: integer
(int64)
Title:
Object IDThe unique identifier of the business object associated with the inbound message. -
ObjectTypeCd: string
Title:
Object TypeMaximum Length:30The type of business object associated with the inbound message, for example SVC_SERVICE_REQUESTS. -
ObjectTypeCdMeaning: string
Title:
Object Type ValueMaximum Length:255The display value corresponding to the object type lookup code for the inbound email. -
PlainTextBody: string
(byte)
Title:
Plain Text BodyThe plain text content of the inbound message. -
ReceivedChannelCd: string
Title:
Received Channel CodeMaximum Length:30The channel type of the inbound message. For example E-Mail or SMS. -
ReceivedDateTime: string
(date-time)
Title:
Received Date TimeIndicates the date and time when the mailbox received the email. -
RetryCount: integer
(int64)
Title:
Retry CountThe number of times the system attempted to process the inbound messages. -
Sender: string
Title:
SenderMaximum Length:320The sender of an inbound message. -
SenderPartyId: integer
(int64)
Title:
Sender Party IDThe party identifier of the person who sent the message. -
SourceMessageId: string
Title:
Source Message IDMaximum Length:2000The message ID in the source system. -
StatusCd: string
Title:
Status CodeMaximum Length:30The current status of the inbound message. For example Received, Processed, or Deleted. -
StatusDetails: string
Title:
Status DetailsMaximum Length:1000The details of the inbound email processing status. -
StatusTypeCdMeaning: string
Title:
Status Type ValueMaximum Length:255The display value corresponding to the status type lookup code for the inbound email. -
StripeCd: string
Title:
Stripe CodeMaximum Length:30The application context of inbound messages. -
StripeCdMeaning: string
Title:
Stripe ValueMaximum Length:255The display value corresponding to the stripe type lookup code for the inbound email. -
StripeCode: string
Title:
Stripe CodeThe application stripe of the inbound message. -
Subject: string
Title:
SubjectMaximum Length:400The subject of the inbound message. -
UpdateFlag: boolean
Title:
Can UpdateRead Only:trueIndicates whether the inbound message can be updated.
Nested Schema : Attachments
Type:
arrayTitle:
AttachmentsThe attachments resource is used to create, view, update, and delete the list of files sent as attachments with the inbound messages. For example, a document with a screenshot of an error message.
Show Source
Nested Schema : Inbound Message Parts
Type:
arrayTitle:
Inbound Message PartsThe inbound message parts resource is used to create, view, update, and delete the list of components of an inbound message, such as From, To, CC, and Importance.
Show Source
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : inboundMessages-Attachments-item-response
Type:
Show Source
object-
AsyncTrackerId: string
Title:
Asynchronous Upload Tracker IdThe attribute provided for the exclusive use by the Attachment UI components to assist in uploading files. -
AttachedDocumentId: integer
(int64)
Title:
Attached Document IdThe unique identifier of the attached document. -
CategoryName: string
Title:
CategoryMaximum Length:30The category of the attachment. - ContentRepositoryFileShared: boolean
-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:255The user who created the attachment. -
CreatedByUserName: string
Title:
Created By User NameRead Only:trueThe name of the user who created the record. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the attachment was created. -
DatatypeCode: string
Title:
TypeMaximum Length:30Default Value:FILEIndicates the data type of the attachment. -
Description: string
Title:
DescriptionMaximum Length:255The description of the attachment. -
DmDocumentId: string
Maximum Length:
255The document ID from which the attachment is created. -
DmFolderPath: string
Title:
Dm Folder PathMaximum Length:1000The folder path of the attachment. -
DmVersionNumber: string
Maximum Length:
255The document version number from which the attachment is created. -
DownloadInfo: string
Title:
DownloadInfoJSON object represented as a string containing information used to programmatically retrieve a file attachment. -
ErrorStatusCode: string
Title:
Error Status CodeThe error code, if any, for the attachment. -
ErrorStatusMessage: string
Title:
Error Status MessageThe error message, if any, for the attachment. -
ExpirationDate: string
(date-time)
Title:
Expiration DateThe expiration date of the contents in the attachment. -
FileContents: string
(byte)
Title:
File ContentsThe contents of the attachment. -
FileName: string
Title:
File NameMaximum Length:2048The file name of the attachment. -
FileUrl: string
Title:
File UrlThe URL of the attached file. -
FileWebImage: string
(byte)
Title:
File Web ImageRead Only:trueThe base64 encoded image of the file displayed in .png format if the source is a convertible image. -
LastUpdateDate: string
(date-time)
Title:
Last Update DateRead Only:trueThe date when the attachment was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:255The user who last updated the attachment. -
LastUpdatedByUserName: string
Title:
Last Updated By UserRead Only:trueThe user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PostProcessingAction: string
Title:
PostProcessingActionThe name of the action that can be performed after an attachment is uploaded. -
Title: string
Title:
TitleThe title of the attachment. -
UploadedFileContentType: string
Title:
Uploaded File Content TypeThe content type of the attachment. -
UploadedFileLength: integer
Title:
File SizeThe length of the attachment file. -
UploadedFileName: string
Title:
Uploaded File NameThe name of the attachment file. -
UploadedText: string
Title:
Uploaded TextThe text of the attachment. -
Uri: string
Title:
UriMaximum Length:4000The URI of the attachment. -
Url: string
Title:
UrlMaximum Length:4000The URL of the attachment. -
UserName: string
Title:
User NameRead Only:trueMaximum Length:255The login of the user associated with the attachment.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Nested Schema : link
Type:
Show Source
object-
href: string
Title:
hyperlink referenceThe URI to the related resource. -
kind: string
Title:
kindAllowed Values:[ "collection", "item", "describe", "other" ]The kind of the related resource. -
name: string
Title:
nameThe name of the link to the related resource. -
properties: object
properties
-
rel: string
Title:
relationAllowed Values:[ "self", "lov", "parent", "canonical", "child", "enclosure", "action", "custom" ]The name of the relation to the resource instance. Example: self.
Nested Schema : properties
Type:
Show Source
object-
changeIndicator: string
Change indicator or the ETag value of the resource instance.
Nested Schema : inboundMessages-InboundMsgParts-item-response
Type:
Show Source
object-
CreatedBy: string
Title:
Created ByRead Only:trueMaximum Length:64The user who created the inbound message part. -
CreationDate: string
(date-time)
Title:
Creation DateRead Only:trueThe date when the inbound message part was created. -
DeleteFlag: boolean
Title:
Can DeleteRead Only:trueIndicates if the inbound message part can be deleted. -
InboundMessageId: integer
(int64)
Title:
Inbound Message IDThe unique identifier of the inbound message with which the message part is associated. -
InboundMsgPartId: integer
(int64)
Title:
Inbound Message Part IDThe unique identifier of the message part. -
LastUpdateDate: string
(date-time)
Title:
Last Updated DateRead Only:trueThe date when the inbound message part was last updated. -
LastUpdatedBy: string
Title:
Last Updated ByRead Only:trueMaximum Length:64The user who last updated the inbound message part. -
LastUpdateLogin: string
Title:
Last Update LoginRead Only:trueMaximum Length:32The login of the user who last updated the record. -
links: array
Links
Title:
LinksThe link relations associated with the resource instance. -
PartName: string
Title:
Part NameMaximum Length:64The header name of the inbound message part. -
PartTypeCd: string
Title:
Part Type CodeMaximum Length:30The type of the inbound message part. -
PartTypeCdMeaning: string
Title:
Part Type ValueMaximum Length:255The display value corresponding to the part type lookup code for the inbound message. -
PartValue: string
Title:
Part ValueMaximum Length:2000The value of the inbound message part. -
UpdateFlag: boolean
Title:
Can UpdateRead Only:trueIndicates if the inbound message part can be updated.
Nested Schema : Links
Type:
arrayTitle:
LinksThe link relations associated with the resource instance.
Show Source
Links
- Attachments
-
Parameters:
- InboundMessageId:
$request.path.InboundMessageId
The attachments resource is used to create, view, update, and delete the list of files sent as attachments with the inbound messages. For example, a document with a screenshot of an error message. - InboundMessageId:
- ChannelTypeCdLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_CHANNEL_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: ReceivedChannelCd; Target Attribute: LookupCode
- Display Attribute: LookupCode
- finder:
- ContentTypeCdLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_INBND_CONTENT_TYPE
The following properties are defined on the LOV link relation:- Source Attribute: ContentTypeCd; Target Attribute: LookupCode
- Display Attribute: LookupCode
- finder:
- InboundMsgParts
-
Operation: /crmRestApi/resources/11.13.18.05/inboundMessages/{InboundMessageId}/child/InboundMsgPartsParameters:
- InboundMessageId:
$request.path.InboundMessageId
The inbound message parts resource is used to create, view, update, and delete the list of components of an inbound message, such as From, To, CC, and Importance. - InboundMessageId:
- ObjectTypeCdLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_INBND_OBJECT_TYPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: ObjectTypeCd; Target Attribute: LookupCode
- Display Attribute: LookupCode
- finder:
- StatusTypeCdLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_INBND_MSG_STATUS_TYPE
The following properties are defined on the LOV link relation:- Source Attribute: StatusCd; Target Attribute: LookupCode
- Display Attribute: LookupCode
- finder:
- StripeCodeLookup
-
Parameters:
- finder:
LookupTypeFinder%3BLookupType%3DORA_SVC_STRIPE_CD
The following properties are defined on the LOV link relation:- Source Attribute: StripeCode; Target Attribute: LookupCode
- Display Attribute: LookupCode
- finder:
Examples
Use GET with the following URI syntax to get details of a specific inbound message:
Example of Request URI
The following shows an example of the request URL.
https://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080
Example of Request Header
The following shows an example of the request header.
GET /crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080 HTTP/1.1 HOST: servername.fa.us2.oraclecloud.com authorization: Basic U0FMRVNfQURNSU46V2VsY29tZTE= content-type: application/vnd.oracle.adf.resourceitem+json
Example of Response Header
The following shows an example of the response header.
HTTP/1.1 200: OK Date: Mon, 18 Jan 2017 09:15:04 GMT Server: Oracle-HTTP-Server-11g Content-Type: application/vnd.oracle.adf.resourceitem+json Content-Language: en
Example of Response Body
The following shows an example of the response body in JSON format.
Content type:
{
"InboundMessageId": 300100095233080,
"Sender": "abc@oracle.com",
"FusionRecipient": "recipient@servername.fa.us2.oraclecloud.com",
"Subject": "Testing REST API",
"ContentTypeCd": "ORA_SVC_TEXT_HTML",
"StatusCd": "ORA_SVC_PROCESSED",
"ReceivedChannelCd": "ORA_SVC_EMAIL",
"AcknowledgedDate": "2016-05-24T01:47:47-07:00",
"CreationDate": "2017-01-18T01:04:38-08:00",
"CreatedBy": "SALES_ADMIN",
"LastUpdateDate": "2017-01-18T01:04:38-08:00",
"LastUpdatedBy": "SALES_ADMIN",
"ChannelId": 2,
"ObjectId": 300100095233089,
"ObjectTypeCd": "SVC_SERVICE_REQUESTS",
"BatchId": 300100095233079,
"RetryCount": 0,
"StripeCode": "ORA_SVC_CRM",
"links": [
{
"rel": "self",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080",
"name": "inboundMessages",
"kind": "item",
"properties": {
"changeIndicator": "ACED0005737200136A6176612E7574696C2E41727261794C6973747881D21D99C7619D03000149000473697A65787000000001770400000001737200116A6176612E6C616E672E496E746567657212E2A0A4F781873802000149000576616C7565787200106A6176612E6C616E672E4E756D62657286AC951D0B94E08B020000787200106A6176612E6C616E672E4F626A656374000000000000000000000078700000000178"
}
},
{
"rel": "canonical",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080",
"name": "inboundMessages",
"kind": "item"
},
{
"rel": "child",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/child/InboundMsgParts",
"name": "InboundMsgParts",
"kind": "collection"
},
{
"rel": "child",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/child/Attachments",
"name": "Attachments",
"kind": "collection"
},
{
"rel": "enclosure",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/enclosure/Body",
"name": "Body",
"kind": "other"
},
{
"rel": "enclosure",
"href": "http://servername.fa.us2.oraclecloud.com/crmRestApi/resources/11.13.18.05/inboundMessages/300100095233080/enclosure/PlainTextBody",
"name": "PlainTextBody",
"kind": "other"
}
],
}