Get all communication details logs

get

/fscmRestApi/resources/11.13.18.05/publicSectorCommunicationRecordDetails

Request

Query Parameters
  • 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).
  • 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
  • Used as a predefined finder to search the collection.

    Format: ?finder=<finderName>;<variableName>=<variableValue>,<variableName2>=<variableValue2>

    The following are the available finder names and corresponding finder variables:

    • PrimaryKey: Finds a communication log that matches the specified primary key criteria.
      Finder Variables:
      • LogId; integer; The unique identifier for the communication request log.
      • LogMessageId; integer; The unique identifier for the communication log message.
    • simpleSearchFinder: Finds communication logs with the specified key word.
      Finder Variables:
      • value; string; The key word used to find a communication log such as status, channel type, or mime type.
  • This parameter restricts the number of resources returned inside the resource collection. If the limit exceeds the resource count then the framework will only return the available resources.
  • 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
  • Used to define the starting position of the resource collection. If offset exceeds the resource count then no resources are returned. Default value is 0.
  • The resource item payload will be filtered in order to contain only data (no links section, for example).
  • This parameter orders a resource collection based on the specified fields. The parameter value is a comma-separated string of attribute names, each optionally followed by a colon and "asc" or "desc". Specify "asc" for ascending and "desc" for descending. The default value is "asc". For example, ?orderBy=field1:asc,field2:desc
  • This query parameter defines the where clause. The resource collection will be queried using the provided expressions. The value of this query parameter is one or more expressions. Example: ?q=Deptno>=10 and <= 30;Loc!=NY

    Format: ?q=expression1;expression2

    You can use these queryable attributes to filter this collection resource using the q query parameter:
    • AgencyId; integer; The unique identifier of the agency associated with the communication request log.
    • ApplicationAddress1; string; The Application Address Line 1 for Business Entity Location.
    • ApplicationAddress2; string; The Application Address Line 2 for Business Entity Location.
    • ApplicationAddress3; string; The Application Address Line 3 for Business Entity Location.
    • ApplicationAddress4; string; The Application Address Line 4 for Business Entity Location.
    • ApplicationCity; string; The Application City Name for Business Entity Location.
    • ApplicationCountry; string; The Application Country Name for Business Entity Location.
    • ApplicationCounty; string; The Application County Name for Business Entity Location.
    • ApplicationDbaBusinessName; string; Doing Business As name for Business Entity Location.
    • ApplicationOrganizationName; string; Organization Name for Business Entity Location.
    • ApplicationPostal; string; Postal code for Business Entity Location.
    • ApplicationState; string; State name for Business Entity Location.
    • AttachRowCount; string; The count of attachments for the communication.
    • BccEmailAddress; string; The blind copied recipient addresses for email communications.
    • CcEmailAddress; string; The copied recipient addresses for email communications.
    • ChannelType; string; The communication message channel type.
    • ChannelTypeMeaning; string; The communication channel type. The possible values are Email, Notification, and Alert.
    • CreatedBy; string; The user who created the communication message.
    • CreationDate; string; The date and time that the communication message was created.
    • EventId; integer; The unique identifier for the communication event.
    • FromAddress; string; The sender of the communication message.
    • LastUpdateDate; string; The user who last updated the communication message.
    • LastUpdatedBy; string; The date that the communication message was last updated.
    • LogId; integer; The unique identifier for the communication request log. This is automatically generated by the application.
    • LogMessageId; integer; The unique identifier for the communication log message. This is automatically generated by the application.
    • MessageDeleteAllowed; string; Indicates whether users are allowed to delete the message.
    • MessageLanguage; string; The language used for the communication message.
    • MessageSeq; integer; The communication message sequence number.
    • MimeType; string; The MIME type of communication message. The possible values are HTML and Text.
    • MimeTypeMeaning; string; The MIME type of communication message. The possible values are HTML and Text.
    • ObjectVersionNumber; integer; The message revision number.
    • PhoneNumber; string; The recipient phone number for text communications.
    • Priority; string; The priority of the notification.
    • Recipient; string; The recipients of the communication message.
    • RecordFifthKeyId; string; The fifth key id name of the communication resource associated with the event.
    • RecordFifthKeyName; string; The fifth key name of the communication resource associated with the event.
    • RecordFifthKeyValue; string; The fifth key value of the communication resource associated with the event.
    • RecordFirstKeyId; string; The first key id name of the communication resource associated with the event.
    • RecordFirstKeyName; string; The first key name of the communication resource associated with the event.
    • RecordFirstKeyValue; string; The first key value of the communication resource associated with the event.
    • RecordFourthKeyId; string; The fourth key id name of the communication resource associated with the event.
    • RecordFourthKeyName; string; The fourth key name of the communication resource associated with the event.
    • RecordFourthKeyValue; string; The fourth key value of the communication resource associated with the event.
    • RecordIdentifier; string; The communication request identifier passed through the communication request.
    • RecordSecondKeyId; string; The second key id name of the communication resource associated with the event.
    • RecordSecondKeyName; string; The second key name of the communication resource associated with the event.
    • RecordSecondKeyValue; string; The second key value of the communication resource associated with the event.
    • RecordSubIdentifier; string; The communication request sub identifier passed through the communication request.
    • RecordThirdKeyId; string; The third key id name of the communication resource associated with the event.
    • RecordThirdKeyName; string; The third key name of the communication resource associated with the event.
    • RecordThirdKeyValue; string; The third key value of the communication resource associated with the event.
    • ShortMessage; string; The short text message body.
    • SourceDescription; string; The event name for which the communication is triggered.
    • Status; string; The status of the communication message.
    • StatusMeaning; string; The status of the communication message.
    • Subject; string; The subject of the communication message.
    • TemplateId; integer; The unique identifier of the template associated with the communication.
    • ToEmailAddress; string; The primary recipient addresses for email communications.
    • UmsMsgId; string; The unique identifier generated by UMS for email messages.
    • UserId; string; The recipient user ID for notifications.
    • Visibility; string; The visibility option of the communication log.
    • VisibilityMeaning; string; The visibility option of the communication message.
    • WebformURL; string; Webform URL details for communication.
  • The resource collection representation will include the "estimated row count" when "?totalResults=true", otherwise the count is not included. The default value is "false".
Header Parameters
  • 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".
  • 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 Top

Response

Supported Media Types

Default Response

The following table describes the default response for this task.
Headers
  • 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".
  • 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.
Body ()
Root Schema : publicSectorCommunicationRecordDetails
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : publicSectorCommunicationRecordDetails-item-response
Type: object
Show Source
  • Title: Agency ID
    Read Only: true
    Default Value: 1
    The unique identifier of the agency associated with the communication request log.
  • Title: Application Address 1
    Maximum Length: 240
    The Application Address Line 1 for Business Entity Location.
  • Title: Application Address 2
    Maximum Length: 240
    The Application Address Line 2 for Business Entity Location.
  • Title: Application Address 3
    Maximum Length: 240
    The Application Address Line 3 for Business Entity Location.
  • Title: Application Address 4
    Maximum Length: 240
    The Application Address Line 4 for Business Entity Location.
  • Title: Application City
    Maximum Length: 60
    The Application City Name for Business Entity Location.
  • Title: Application Country
    Maximum Length: 3
    The Application Country Name for Business Entity Location.
  • Title: Application County
    Maximum Length: 20
    The Application County Name for Business Entity Location.
  • Title: Doing Business As
    Maximum Length: 360
    Doing Business As name for Business Entity Location.
  • Title: Organization Name
    Maximum Length: 360
    Organization Name for Business Entity Location.
  • Title: Application Postal Code
    Maximum Length: 60
    Postal code for Business Entity Location.
  • Title: Application State
    Maximum Length: 60
    State name for Business Entity Location.
  • Read Only: true
    The count of attachments for the communication.
  • Title: Bcc Email Address
    Read Only: true
    The blind copied recipient addresses for email communications.
  • Title: Body
    Read Only: true
    The communication message body text.
  • Title: Cc Email Address
    Read Only: true
    The copied recipient addresses for email communications.
  • Title: Channel Type
    Read Only: true
    Maximum Length: 30
    The communication message channel type.
  • Read Only: true
    Maximum Length: 80
    The communication channel type. The possible values are Email, Notification, and Alert.
  • Title: Created By
    Read Only: true
    Maximum Length: 64
    The user who created the communication message.
  • Title: Creation Date
    Read Only: true
    The date and time that the communication message was created.
  • Title: Event ID
    The unique identifier for the communication event.
  • Title: From Address
    Read Only: true
    Maximum Length: 256
    The sender of the communication message.
  • Title: Last Updated Date
    Read Only: true
    The user who last updated the communication message.
  • Title: Last Updated By
    Read Only: true
    Maximum Length: 64
    The date that the communication message was last updated.
  • Links
  • Title: Log ID
    Read Only: true
    The unique identifier for the communication request log. This is automatically generated by the application.
  • Title: Log Message ID
    Read Only: true
    The unique identifier for the communication log message. This is automatically generated by the application.
  • Read Only: true
    Maximum Length: 1
    Indicates whether users are allowed to delete the message.
  • Title: Message Language
    Read Only: true
    Maximum Length: 4
    The language used for the communication message.
  • Title: Message Sequence
    Read Only: true
    The communication message sequence number.
  • Title: MIME Type
    Read Only: true
    Maximum Length: 30
    The MIME type of communication message. The possible values are HTML and Text.
  • Read Only: true
    Maximum Length: 80
    The MIME type of communication message. The possible values are HTML and Text.
  • The message revision number.
  • Title: To Phone Number
    Read Only: true
    The recipient phone number for text communications.
  • Title: Priority
    Read Only: true
    Maximum Length: 1
    The priority of the notification.
  • Title: Sent To
    Read Only: true
    The recipients of the communication message.
  • Title: Record Fifth Key ID
    Maximum Length: 100
    The fifth key id name of the communication resource associated with the event.
  • Title: Record Fifth Key Name
    Read Only: true
    Maximum Length: 32
    The fifth key name of the communication resource associated with the event.
  • Title: Record Fifth Key Value
    Read Only: true
    Maximum Length: 100
    The fifth key value of the communication resource associated with the event.
  • Title: Record First Key ID
    Maximum Length: 100
    The first key id name of the communication resource associated with the event.
  • Title: Record First Key Name
    Read Only: true
    Maximum Length: 32
    The first key name of the communication resource associated with the event.
  • Title: Record First Key Value
    Read Only: true
    Maximum Length: 100
    The first key value of the communication resource associated with the event.
  • Title: Record Fourth Key ID
    Maximum Length: 100
    The fourth key id name of the communication resource associated with the event.
  • Title: Record Fourth Key Name
    Read Only: true
    Maximum Length: 32
    The fourth key name of the communication resource associated with the event.
  • Title: Record Fourth Key Value
    Read Only: true
    Maximum Length: 100
    The fourth key value of the communication resource associated with the event.
  • Title: Record Identifier
    Read Only: true
    Maximum Length: 100
    The communication request identifier passed through the communication request.
  • Title: Record Second Key ID
    Maximum Length: 100
    The second key id name of the communication resource associated with the event.
  • Title: Record Second Key Name
    Read Only: true
    Maximum Length: 32
    The second key name of the communication resource associated with the event.
  • Title: Record Second Key Value
    Read Only: true
    Maximum Length: 100
    The second key value of the communication resource associated with the event.
  • Title: Record Subidentifier
    Read Only: true
    Maximum Length: 100
    The communication request sub identifier passed through the communication request.
  • Title: Record Third Key ID
    Maximum Length: 100
    The third key id name of the communication resource associated with the event.
  • Title: Record Third Key Name
    Read Only: true
    Maximum Length: 32
    The third key name of the communication resource associated with the event.
  • Title: Record Third Key Value
    Read Only: true
    Maximum Length: 100
    The third key value of the communication resource associated with the event.
  • Title: Short Message
    Read Only: true
    Maximum Length: 4000
    The short text message body.
  • Title: Event Name
    Maximum Length: 500
    The event name for which the communication is triggered.
  • Title: Status
    Read Only: true
    Maximum Length: 30
    The status of the communication message.
  • Read Only: true
    Maximum Length: 80
    The status of the communication message.
  • Title: Subject
    Read Only: true
    Maximum Length: 1000
    The subject of the communication message.
  • Title: Template ID
    Read Only: true
    The unique identifier of the template associated with the communication.
  • Title: To Email Address
    Read Only: true
    The primary recipient addresses for email communications.
  • Title: UMS Message ID
    Read Only: true
    Maximum Length: 150
    The unique identifier generated by UMS for email messages.
  • Title: To User ID
    Read Only: true
    The recipient user ID for notifications.
  • Title: Visibility
    Read Only: true
    Maximum Length: 30
    The visibility option of the communication log.
  • Read Only: true
    Maximum Length: 80
    The visibility option of the communication message.
  • Web Forms
    Title: Web Forms
    The web forms resource is used to view web form details associated with the communications triggered through ad hoc emails and ad hoc notifications.
  • Read Only: true
    Maximum Length: 255
    Webform URL details for communication.
Nested Schema : Web Forms
Type: array
Title: Web Forms
The web forms resource is used to view web form details associated with the communications triggered through ad hoc emails and ad hoc notifications.
Show Source
Nested Schema : publicSectorCommunicationRecordDetails-WebForms-item-response
Type: object
Show Source
Back to Top