Get Service Call
get
https://server:port/rest/apis/asset/work/serviceCalls/{serviceCallId}
This operation is used to retrieve additional information about the service call. All communication logs for the service call are also returned.
Request
Path Parameters
-
serviceCallId(required): string
test descExample:
test example
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : W1GetSCDtls
Type:
Show Source
object-
address1: string
Maximum Length:
254The first line of the service call address.Example:800 Rosewood Ave -
address2: string
Maximum Length:
254The second line of the service call address.Example:Suite 101 -
address3: string
Maximum Length:
254The third line of the service call address. -
address4: string
Maximum Length:
254The fourth line of the service call address. -
callbackCompleted: string
Allowed Values:
[ "W1NO", "W1YS" ]Indicates if the utility has called the customer back. * `W1NO` - No, * `W1YS` - YesExample:W1NO -
callbackRequired: string
Allowed Values:
[ "W1NO", "W1YS" ]Indicates if the customer expects a callback from the utility. * `W1NO` - No, * `W1YS` - YesExample:W1YS -
city: string
Maximum Length:
90The city of the service call address.Example:North Canton -
communicationlogs: array
communicationlogs
-
country: string
Maximum Length:
3The country of the service call address.Example:USA -
county: string
Maximum Length:
90The county of the service call address.Example:Fulton -
creationDateTime: string
(date-time)
The creation date and time of the service call.Example:
2022-06-05T10:30:49-07:00 -
crossStreet: string
Maximum Length:
64The major intersection of the service call address.Example:Rosewood and Main -
description: string
Maximum Length:
100Short description about the service call.Example:New Electric Service -
detailedDescription: string
Maximum Length:
4000Additional information about the service call.Example:New electric service - customer requesting a meter read -
firstName: string
Maximum Length:
254The first name of the contact person.Example:Robert -
geographicCode: string
Maximum Length:
11The geographic code of the service call address. -
homePhone: string
Maximum Length:
24The home phone number of the contact person.Example:330-532-9834 -
houseType: string
Allowed Values:
[ "AP ", "CM " ]The property type of the service call address. * `AP ` - Apartment, * `CM ` - CondominiumExample:AP -
inCityLimit: boolean
Indicates if the service call address is within the city boundary.
-
info: string
Maximum Length:
1000Contains relevant information about the service call.Example:20220000001209, New Electric Service, Created By: External System, Processed -
lastName: string
Maximum Length:
254The last name of the contact person.Example:Brown -
latitude: number
Minimum Value:
0Maximum Value:999999999.999999The latitude coordinate of the service call address.Example:40.558270 -
location: object
location
-
longitude: number
Minimum Value:
-999999999.999999Maximum Value:999999999.999999The longitude coordinate of the service call address.Example:-90.035090 -
mobilePhone: string
Maximum Length:
24The mobile phone number of the contact person.Example:330-532-9834 -
number1: string
Maximum Length:
6Address number 1 of the service call address. -
number2: string
Maximum Length:
4Address number 2 of the service call address. -
postal: string
Maximum Length:
12The zip code of the service call address.Example:61520 -
primaryPhone: string
Maximum Length:
24The primary phone number of the contact person.Example:330-532-9834 -
requiredByDate: string
(date)
The date when the work needs to be completed.Example:
2022-06-10 -
serviceCallExternalId: string
Maximum Length:
60The external system's unique identifier for the asset location.Example:300000354678942 -
serviceCallId: string
Maximum Length:
14The system-generated unique identifier for the service call.Example:20124908366206 -
serviceCallNumber: string
Maximum Length:
14The alternative unique identifier for the service call.Example:20220000001209 -
serviceCategory: object
serviceCategory
Service category represents a broad grouping of services provided by the company.
-
serviceCode: object
serviceCode
Service code is used to assign actions corresponding to the service call received.
-
state: string
Maximum Length:
6The state of the service call address.Example:IL -
status: string
Maximum Length:
60The current status of the service call.Example:Processed -
suburb: string
Maximum Length:
64The suburb of the service call address.Example:Peoria Metropolitan
Nested Schema : location
Type:
Show Source
object-
_link: string
_link
-
locationId: string
Maximum Length:
12Location/Organization
Nested Schema : serviceCategory
Type:
objectService category represents a broad grouping of services provided by the company.
Show Source
-
_link: string
_link
-
serviceCategory: string
Maximum Length:
30Service category represents a broad grouping of services provided by the company.Example:CM_ElectricService
Nested Schema : serviceCode
Type:
objectService code is used to assign actions corresponding to the service call received.
Show Source
-
_link: string
_link
-
serviceCode: string
Maximum Length:
30Service code is used to assign actions corresponding to the service call received.Example:CM_MeterRead
Nested Schema : items
Type:
Show Source
object-
comments: string
Maximum Length:
4000Information from the customer.Example:Follow up on the meter read. -
communication: object
communication
-
communicationExternald: string
Maximum Length:
254The external system's unique identifier for the communication log.Example:CN189761809 -
communicationType: string
Allowed Values:
[ "W1CN", "W1EM", "W1PH" ]Indicates how the communication was received from the customer. * `W1CN` - Counter, * `W1EM` - Email, * `W1PH` - PhoneExample:Email -
creationDateTime: string
(date-time)
The creation date and time of the communication log.Example:
2022-06-09T12:35:44-07:00 -
firstName: string
Maximum Length:
254The first name of the contact person.Example:Robert -
homePhone: string
Maximum Length:
24The home phone number of the contact person.Example:330-532-9834 -
info: string
Maximum Length:
1000Contains relevant information about the communication log.Example:06-03-2022 05:20PM, Email, Brown, Robert, Primary Phone: 330-532-9834 -
lastName: string
Maximum Length:
254The last name of the contact person.Example:Brown -
mobilePhone: string
Maximum Length:
24The mobile phone number of the contact person.Example:330-532-9834 -
primaryPhone: string
Maximum Length:
24The primary phone number of the contact person.Example:330-532-9834 -
response: string
Maximum Length:
4000Response from the utility.Example:Meter read scheduled on Friday between 9-11 am.
Nested Schema : communication
Type:
Show Source
object-
_link: string
_link
-
communicationId: string
Maximum Length:
14The system-generated unique identifier for the communication log.Example:17796561499666
400 Response
Bad Request
Root Schema : problemDetailDocument
Type:
Show Source
object-
detail: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0Maximum Value:9999The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object-
callSequence: string
Maximum Length:
60Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0Maximum Value:0Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999Maximum Value:99999Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60Name of the program that encountered the error.
500 Response
Internal Server Error
Root Schema : problemDetailDocument
Type:
Show Source
object-
detail: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0Maximum Value:9999The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60Fully qualified URL consisting of the Base URI Timestamp of error in ISO format, the User used for the transaction, the Message Category within Oracle Utilities Application Framework, the Message Number within Oracle Utilities Application Framework, the Request URL and the HTTP method used for the transaction. -
problemType: string
Maximum Length:
60URL of the format "A/message/X/Y" where A is the base URI, X is the Message Category and Y is the Message Number within Oracle Utilities Application Framework. -
serverMessage: object
serverMessage
-
stackTrace: string
Maximum Length:
60The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object-
callSequence: string
Maximum Length:
60Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0Maximum Value:0Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999Maximum Value:99999Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60Name of the program that encountered the error.