Get all workflow communication items

get

/fscmRestApi/resources/11.13.18.05/publicSectorWorkflowCommunications

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 workflow communication data with the specified record key.
      Finder Variables:
      • LnpRecordKey; integer; The unique identifier for the record key.
    • findByBRFCriteria: Finds workflow communication data that satisfies the criteria provided.
      Finder Variables:
      • Caller; string; The application making the call. It should always be BRF.
      • Criteria; string; The criteria for the rows. This should be formatted with semicolons before and after the field names. For example (;ApplicantCountry; = 'US') AND (;RecordType; = 'Permit1001').
  • 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:
    • AboutToExpireDate; string; The date when the notification about an expiring license or permit is sent.
    • AddressKey; integer; The parcel address key.
    • AgencyId; integer; The identifier for a public sector agency. This is usually an alphanumeric identifier for a city, county, or state, but it can also be the name of a city, county, or state.
    • AppAcceptDate; string; Identifies the accepted date for the permit application.
    • ApplAteDate; string; Identifies the date on which an about-to-expire notification is sent for the permit application.
    • ApplExpirationDate; string; The date the application expires.
    • Applicant; integer; The party ID of the permit applicant.
    • ApplicantAddress1; string; The first line of the permit applicant address.
    • ApplicantAddress2; string; The second line of the permit applicant address.
    • ApplicantBizProfileId; integer; The business profile used by the applicant.
    • ApplicantCity; string; The city in the permit applicant address.
    • ApplicantCountry; string; The country in the permit applicant address.
    • ApplicantCounty; string; The county in the permit applicant address.
    • ApplicantEmailAddress1; string; The first email address of the permit applicant.
    • ApplicantEmailAddress2; string; The second email address of the permit applicant.
    • ApplicantPersonName; string; The permit applicant name.
    • ApplicantPhoneAreaCode; string; The area code in the phone number of the permit applicant.
    • ApplicantPhoneCountryCode; string; The country code in the phone number of the permit applicant.
    • ApplicantPhoneExtension; string; The phone number extension for the permit applicant.
    • ApplicantPhoneNumber; string; The permit applicant phone number.
    • ApplicantPostalCode; string; The postal code in the permit applicant address.
    • ApplicantProfileId; integer; The user profile of the applicant.
    • ApplicantProvince; string; The province in the permit applicant address.
    • ApplicantState; string; The state in the permit applicant address.
    • ApplicantUserId; string; The user ID of the permit applicant.
    • BalanceDue; number; The total fees balance due for the permit application.
    • CancelledByName; string; Identifies the user name of the person who canceled the permit application.
    • CancelledCreatedBy; string; Identifies the user ID of the person who canceled the permit application.
    • CancelledCreationDate; string; Identifies the cancelation date of the permit application.
    • CancelledReason; string; Identifies the reason for the cancelation of the permit application.
    • Classification; string; The record classification. The classifications can be permit, business license, professional license, or planning and zoning.
    • ClassificationMeaning; string; Identifies the classification of the permit application type.
    • CreatedBy; string; Identifies the user ID of the person who created the permit application.
    • CreatedByName; string; Identifies the user name of the person who created the permit application.
    • CreationDate; string; Identifies the date on which the permit application was created.
    • CurrencyCode; string; Identifies the currency code.
    • DelinquentDate; string; The date the license becomes delinquent.
    • DistrictName; string; The name of the district in which the property is located.
    • ExpirationDate; string; The date the license or permit is no longer valid.
    • ExpirationGraceDate; string; Identifies the expiration grace date for the permit application.
    • ExpirationStatus; string; Identifies the expiration status of the permit application.
    • FeeDueUpdateDate; string; Identifier that captures the date when fee item with due status is added or updated.
    • GenFloorAreaAddl; number; The additional floor area for construction. The floor area refers to the square footage of the construction area. Used in the construction information component of the Permit Designer.
    • GenFloorAreaExist; number; The area of the existing floor in the building. Used in the construction information component of the Permit Designer.
    • GenFloorAreaTotal; number; The total floor area under construction. Used in the construction information component of the Permit Designer.
    • GenJobCost; number; The cost of the construction job. Used in the construction information component of the Permit Designer.
    • GenNewFloorAreaClass; string; The classification of the new floor area. Used in the construction information component of the Permit Designer.
    • GenTotalNumStories; number; The total number of stories of the structure under construction. Used in the construction information component of the Permit Designer.
    • GenTypeConstruction; string; The type of construction. Used in the construction information component of the Permit Designer.
    • GenTypeOfUse; string; The intended use of the construction. Used in the construction information component of the Permit Designer.
    • GenTypeOfWork; string; The type of construction work. Used in the construction information component of the Permit Designer.
    • IssueDate; string; The date the license or permit was issued. Used in the application information component of the Permit Designer.
    • LastAction; string; Indicates the last action performed on the transaction.
    • LastUpdateDate; string; Identifies the last updated date of the permit application.
    • LastUpdatedBy; string; Identifies the user ID of the person who last updated the permit application.
    • LastUpdatedByName; string; Identifies the user name of the person who last updated the permit application.
    • Latitude; number; The geographic location of the parcel that is to the North or South of the equator.
    • LicenseStatus; string; The overall status of the business license.
    • LnpRecordId; string; The identifier for the building permit record. For example, a permit number with a value such as Building Permit ID RA-2017-00029.
    • LnpRecordKey; integer; The unique identifier for the record.
    • Longitude; number; The geographic location of the parcel that is to the East or West of the meridian. It typically points to a specific entrance area within a large parcel, for example, a security checkpoint gate, delivery entrance, or employee entrance.
    • OrganizationName; string; The business name of the applicant. For example, a contractor enters his or her contracting business name.
    • Originator; string; Identifies the originator of the permit application.
    • Owner; string; The primary or only owner of the parcel or property.
    • OwnerEmailId; string; The parcel owner email address.
    • OwnerId; integer; The owner ID of the record parcel owner.
    • OwnerKey; integer; The owner key of the record parcel owner.
    • ParcelAddress1; string; The first line of the parcel or property address.
    • ParcelAddress2; string; The second line of the parcel or property address.
    • ParcelCity; string; The city in the parcel or property address.
    • ParcelCountry; string; The country in the parcel or property address.
    • ParcelCounty; string; The county in the parcel or property address.
    • ParcelId; integer; The identifier of the record parcel.
    • ParcelKey; integer; The key of the record parcel.
    • ParcelPostalCode; string; The postal code in the parcel or property address.
    • ParcelProvince; string; The province in the parcel or property address.
    • ParcelState; string; The state in the parcel or property address.
    • ParcelType; string; The type of the current parcel.
    • Parentclassificationmeaning; string; The application type classification of the primary application.
    • Parentfeedueupdate; string; The date on which the fees due was updated for the primary application.
    • Parentgenjobcost; number; The job cost for the primary application.
    • Parentrecordid; string; The identifier of the primary application.
    • Parentrecordkey; integer; The record ID of the primary application.
    • Parentrecordtype; string; The application type of the primary application.
    • Parentsubclassificationmeaning; string; The application type subclassification of the primary application.
    • PermitDescription; string; The description of the permit type.
    • PermitStatus; string; The status of the permit record.
    • PersonFirstName; string; The applicant first name.
    • PersonLastName; string; The applicant last name.
    • PersonMiddleName; string; The applicant middle name.
    • PersonTitle; string; The title of the contact.
    • PrimaryBalanceDue; number; The balance due for the primary application.
    • PrimaryContactPhonenumber; string; Identifies the phone number of the primary contact of the permit application.
    • PrimaryContatUserId; string; Identifies the user ID of the primary contact.
    • PrimaryFlag; string; The application's relationship type as primary application.
    • PrimaryTotalFees; number; The total fees for the primary application.
    • PrimaryTotalOutstanding; number; The total outstanding fee balance for the primary application.
    • PrimaryTotalPaid; number; The total fees paid of the primary application.
    • Primaryapplicationflagmeaning; string; The application's relationship type as primary application.
    • Primarycontactemail; string; Identifies the email of the primary contact of the permit application.
    • Primarycontactname; string; Identifies the primary contact name of the permit application.
    • Primarycontactpartyid; integer; Identifies the party ID of the primary contact of the permit application.
    • Primarycontactphoneextension; string; The contact phone number extension for the primary contact.
    • Primarycontacttype; string; Identifies the contact type of the primary contact of the permit application.
    • Primaryissuedate; string; The issue date of the primary application.
    • Primarypermitdescription; string; The description of the primary application.
    • Primarypermitstatus; string; The status of the primary application.
    • Primaryreissuedate; string; The reissue date of the primary application.
    • Primarysystemstatus; string; The system status of the primary application.
    • Primarysystemstatusmeaning; string; The system status of the primary application.
    • ProjectKey; integer; The project name information for a permit.
    • PropertyDescription; string; The property description.
    • ReceivedDate; string; Identifies the received date for the permit application.
    • RecordStatus; string; The status of the record.
    • RecordType; string; The permit type. Agencies define the types of permits that they administer, for example, Residential Addition.
    • RecordTypeId; string; The identifier for a record type.
    • ReissueDate; string; The date the license or permit was reissued. Used in the application information component of the Permit Designer.
    • RenewalDate; string; The renewal date for the license or permit.
    • RowType; string; The identifier for a record type.
    • SecondaryOwner; string; The secondary owner of the parcel or property.
    • SubapplicationFlag; string; The application's relationship type as subapplication.
    • Subapplicationflagmeaning; string; The application's relationship type as subapplication.
    • Subclassification; string; The subclassification code of the permit application type.
    • SubclassificationMeaning; string; Identifies the subclassification of the permit application type.
    • SubmitDate; string; The date the license and permit transaction was submitted. Used in the application information component of the Permit Designer.
    • SubmittedBy; string; Identifies the user ID of the person who submitted the permit application.
    • SubmittedByName; string; Identifies the user name of the person who submitted the permit application.
    • SystemStastusMeaning; string; The system status description of the permit application.
    • SystemStatus; string; Identifies the system status of the permit application.
    • TotalFees; number; The total fees for the permit application.
    • TotalHold; number; Identifies the total hold fee amount.
    • TotalOutstanding; number; Identifies the total outstanding fee amount.
    • TotalPaid; number; The total fees paid for the permit application.
    • TotalPayable; number; The total fees payable for the permit application.
    • TotalPending; number; Identifies the total pending fee amount.
    • TotalWaived; number; Identifies the total fee waived.
    • Url; string; The URL label for the permit application.
    • UrlLabel; string; The URL for the permit application.
    • VersionType; string; Indicates the version type.
    • WfNoOrigFlag; string; Indicates that the transaction type does not contain an origination workflow.
    • WithDrawnByName; string; Identifies the user name of the person who withdrew the permit application.
    • WithdrawnCreatedBy; string; Identifies the user ID of the person who withdrew the permit application.
    • WithdrawnCreatedDate; string; Identifies the withdrawal date of the permit application.
    • WithdrawnReason; string; Identifies the reason for the withdrawal of the permit application.
  • 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 : publicSectorWorkflowCommunications
Type: object
Show Source
Nested Schema : Items
Type: array
Title: Items
The items in the collection.
Show Source
Nested Schema : publicSectorWorkflowCommunications-item-response
Type: object
Show Source
Back to Top