Get Field Activity Summary
get
/rest/apis/meter/service/fieldActivities/{activityId}/summary
Request
Path Parameters
-
activityId(required): string
System-generated unique identifier for the field activity.
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : D1FASummary
Type:
Show Source
object-
_self: string
_self
-
activityId: string
Maximum Length:
14System-generated unique identifier for the field activity. -
activityType: object
activityType
Activity Type
-
appointmentInformation: object
appointmentInformation
-
appointmentWindow: object
appointmentWindow
-
bo: string
Maximum Length:
30The business object (BO) of the Service Order Management Activity. -
boStatus: string
Maximum Length:
12The current status code of the service order field activity. -
boStatusDescription: string
Maximum Length:
254The current status description of the service order field activity. -
cancelReason: string
Allowed Values:
[ "M2-INCOMPLETE", "CUT", "SEVER", "D1-Undetermined", "NEARMR", "UNDETER", "CR", "INCMPLTE", "C1SR", "WFA", "D1-AutoDiscarded", "STRSTP", "DEVTST", "CXS" ]Cancel Reason: * `M2-INCOMPLETE` - INCOMPLETE, * `CUT` - Cut Canceled, * `SEVER` - Severance Canceled, * `D1-Undetermined` - Undetermined, * `NEARMR` - Near MR Completion Canceled, * `UNDETER` - Undetermined, * `CR` - Customer requested, * `INCMPLTE` - Incomplete, * `C1SR` - Activity Failed, * `WFA` - Wrong type of field act. type, * `D1-AutoDiscarded` - Auto Discarded, * `STRSTP` - Start Stop Canceled, * `DEVTST` - Device Test Canceled, * `CXS` - Canceled by external system -
cancelReasonDescription: string
Maximum Length:
60Description -
creationDateTime: string
(date-time)
Create Date/Time
-
emergency: string
Allowed Values:
[ "N ", "Y " ]A flag that indicates if the activity is an emergency or not. * `N ` - No, * `Y ` - YesExample:N -
externalActivityDetails: object
externalActivityDetails
-
fieldTaskType: string
Allowed Values:
[ "D1-DisconnectItemSPAtSource", "D1-ConnectSPAtSourceAndTurnOn", "D1-DisconnectSPAtSource", "D1-DisconnectWarning", "D1-MaintainEquipment", "D1-ExchangeMeter", "D1-DisConnSPAtDvcAndRmveDvc", "D1-TurnOffItem", "D1-ConnSPAtSrceAndInstMtr", "D1-TurnOnMeter", "D1-CutForNonPayment", "D1-DisConnSPAtSrceAndRmveMtr", "D1-ReconnectItemforPayment", "D1-TurnOffMeter", "D1-ConnectSPAtMeterAndTurnOn", "D1-DisconnectSPAtDevice", "D1-ConnectSPAtDevice", "D1-InstallDevice", "D1-ConnSPAtDvcAndInstDvc", "D1-ConnSPAtSrceAndTurnOnDvc", "D1-TurnOnPilotLight", "D1-ConnectSPAtSource", "D1-DisconnectSPAtMeter", "D1-ConnSPAtSrceAndInstDvc", "D1-ConnectSPAtMeter", "D1-ServiceInvestigation", "D1-DisConnSPAtMtrAndRmveMtr", "D1-InstallMeter", "D1-ReconnectForPayment", "D1-ConnectSPAtDvcAndTurnOn", "D1-TrimTree", "D1-ConnSPAtMtrAndInstMtr", "D1-CutItemForNonPayment", "X1-InvestigateControllableDevice", "D1-RemoveMeter", "D1-ConnectSPAtSourceAndInstallMeter", "D1-TurnOnItem", "D1-ReadMeter", "D1-RemoveDevice", "D1-ExchangeDevice", "X1-InstallControllableDevice" ]A service order field activity's field task type defines details about the type of task to be performed and how the system will process the activity. * `D1-DisconnectItemSPAtSource` - Disconnect SP at Source Item, * `D1-ConnectSPAtSourceAndTurnOn` - Connect SP at Source and Turn On, * `D1-DisconnectSPAtSource` - Disconnect SP at Source, * `D1-DisconnectWarning` - Disconnect Warning, * `D1-MaintainEquipment` - Maintain SP and Meter Equipment, * `D1-ExchangeMeter` - Exchange Meter, * `D1-DisConnSPAtDvcAndRmveDvc` - Disconnect SP from Item and Remove Item, * `D1-TurnOffItem` - Turn Off Item, * `D1-ConnSPAtSrceAndInstMtr` - Connect SP at Source and Install Meter, * `D1-TurnOnMeter` - Turn On Meter, * `D1-CutForNonPayment` - Cut for Non Payment, * `D1-DisConnSPAtSrceAndRmveMtr` - Disconnect SP at Source and Remove Meter, * `D1-ReconnectItemforPayment` - Reconnect Item for Payment, * `D1-TurnOffMeter` - Turn Off Meter, * `D1-ConnectSPAtMeterAndTurnOn` - Connect SP at Meter and Turn On, * `D1-DisconnectSPAtDevice` - Disconnect SP from Item, * `D1-ConnectSPAtDevice` - Connect SP to Item, * `D1-InstallDevice` - Install Item, * `D1-ConnSPAtDvcAndInstDvc` - Connect SP to Item and Install Item, * `D1-ConnSPAtSrceAndTurnOnDvc` - Connect SP at Source and Turn On Item, * `D1-TurnOnPilotLight` - Turn On Pilot Light, * `D1-ConnectSPAtSource` - Connect SP at Source, * `D1-DisconnectSPAtMeter` - Disconnect SP at Meter, * `D1-ConnSPAtSrceAndInstDvc` - Connect SP at Source and Install Item, * `D1-ConnectSPAtMeter` - Connect SP at Meter, * `D1-ServiceInvestigation` - Service Investigation, * `D1-DisConnSPAtMtrAndRmveMtr` - Disconnect SP at Meter and Remove Meter, * `D1-InstallMeter` - Install Meter, * `D1-ReconnectForPayment` - Reconnect for Payment, * `D1-ConnectSPAtDvcAndTurnOn` - Connect SP to Item and Turn On, * `D1-TrimTree` - Trim Tree, * `D1-ConnSPAtMtrAndInstMtr` - Connect SP at Meter and Install Meter, * `D1-CutItemForNonPayment` - Cut Item for Non Payment, * `X1-InvestigateControllableDevice` - Investigate Controllable Device, * `D1-RemoveMeter` - Remove Meter, * `D1-ConnectSPAtSourceAndInstallMeter` - Connect SP at Source and Install Meter, * `D1-TurnOnItem` - Turn On Item, * `D1-ReadMeter` - Read Meter, * `D1-RemoveDevice` - Remove Item, * `D1-ExchangeDevice` - Exchange Item, * `X1-InstallControllableDevice` - Install Controllable DeviceExample:D1-ConnectSPAtMeterAndTurnOn -
fieldTaskTypeDescription: string
Maximum Length:
60Description -
parentActivityDetails: object
parentActivityDetails
-
recipient: string
Maximum Length:
30The field work system service provider to which the service order field activity is sent for scheduling and assignment. -
recommendedDeviceConfigurationType: object
recommendedDeviceConfigurationType
Indicates the recommended device configuration type code for the device to be set or installed with this field activity if applicable.
-
requestInformation: object
requestInformation
-
servicePointDetails: object
servicePointDetails
-
statusDateTime: string
(date-time)
Status Date/Time
Nested Schema : activityType
Type:
objectActivity Type
Show Source
-
_link: string
_link
-
activityType: string
Maximum Length:
30Activity Type -
activityTypeDescription: string
Maximum Length:
60Activity Type
Nested Schema : appointmentInformation
Type:
Show Source
object-
comments: string
Maximum Length:
254Comments -
takenBy: string
Maximum Length:
32Identifier of the user or worker who "took" (accepted or initiated) the activity.Example:EJONES -
takenByUserName: string
Maximum Length:
50User Name -
takenDate: string
(date)
Date the activity was taken or accepted.Example:
2025-09-06
Nested Schema : appointmentWindow
Type:
Show Source
object-
endDateTime: string
(date-time)
End date and time for the activity or appointment window.Example:
2025-09-08T16:00:00-07:00 -
startDateTime: string
(date-time)
Start date and time for the activity or appointment window.Example:
2025-09-07T16:00:00-07:00
Nested Schema : externalActivityDetails
Type:
Show Source
object-
comments: string
Maximum Length:
254Comments -
instructions: string
Maximum Length:
4000Optional instructions can be provided for the field worker. -
startDateTime: string
(date-time)
Start Date/Time
Nested Schema : parentActivityDetails
Type:
Show Source
object-
parentActivity: object
parentActivity
-
parentActivityStartDateTime: string
(date-time)
Start Date/Time
-
parentActivityTypeDescription: string
Maximum Length:
60Description
Nested Schema : recommendedDeviceConfigurationType
Type:
objectIndicates the recommended device configuration type code for the device to be set or installed with this field activity if applicable.
Show Source
-
_link: string
_link
-
recommendedDeviceConfigurationType: string
Maximum Length:
30Indicates the recommended device configuration type code for the device to be set or installed with this field activity if applicable.Example:E-AUTO-KWH-15MIN
Nested Schema : requestInformation
Type:
Show Source
object-
externalReferenceId: string
Maximum Length:
36Represents a unique system-generated id for the activity in the requesting system. -
externalSPType: string
Maximum Length:
30External service point type code as provided by the originating system.Example:E-RES -
faType: string
Maximum Length:
30External field activity type code from the requesting system, often used for integration.Example:SOM-START -
requester: string
Maximum Length:
30The requesting system service provider from which the request was received. -
requesterTransactionId: string
Maximum Length:
120Identifier used by the external requesting system to correlate the transaction.Example:3098684110 -
requesterUserId: string
Maximum Length:
8ID of the user in the requesting system who created the field activity request.Example:LWAYNE -
requesterUserName: string
Maximum Length:
50User Name -
servicePointExternalId: string
Maximum Length:
60The Service Point Identifier in the Customer Care and Billing application data model.
Nested Schema : servicePointDetails
Type:
Show Source
object-
abolishedDate: string
(date)
The date the service or premise record was removed / deactivated or no longer valid.
-
badgedDevice: object
badgedDevice
-
installationDate: string
(date)
The date the service point connection was established at the premise or service point.Example:
2010-01-01 -
isMetered: boolean
Indicates whether the service point usage is metered or not.Example:
true -
premiseAddress: string
Maximum Length:
254The full mailing and/or physical address associated with the premise.Example:123 Main St, San Francisco, CA 94105 -
premiseId: string
Maximum Length:
30Unique identifier of the premise associated with the service point or customer location.Example:7880087160 -
servicePointStatusDescription: string
Maximum Length:
60Description -
servicePointTypeDescription: string
Maximum Length:
60Description -
serviceType: string
Maximum Length:
80Service type defines the type of service associated with the service agreement type.Example:E -
serviceTypeDescription: string
Maximum Length:
100Text description of the service type that can be displayed for users in their language.Example:Electric -
sourceStatusDescription: string
Maximum Length:
60Description -
sp: object
sp
-
unbadgedDevices: array
unbadgedDevices
Nested Schema : parentActivity
Type:
Show Source
object-
_link: string
_link
-
parentActivityId: string
Maximum Length:
14Parent orchestration activity id.
Nested Schema : badgedDevice
Type:
Show Source
object-
badgeNumber: string
Maximum Length:
120Utility badge tag number assigned to a specific installed device or additional equipment that would normally be presented to a customer.Example:EM-784392 -
device: object
device
-
deviceInfo: string
Maximum Length:
150Composite text containing device properties and status of installation and connection as displayed within the application.Example:0G-PRAP - Electric Smart ConGen / Install Date/Time: 09-08-2025 12:00AM / Connected / Commissioned / 0G-PRAP - Electric Service Provider / Active -
deviceInstallationDateTime: string
(date-time)
Date and time when the device was physically installed.Example:
2025-09-07T16:00:00-07:00 -
deviceStatus: string
Maximum Length:
60Current on/off status of the device.Example:On -
deviceTypeDescription: string
Maximum Length:
60Description
Nested Schema : sp
Type:
Show Source
object-
_link: string
_link
-
spId: string
Maximum Length:
12Service Point
Nested Schema : device
Type:
Show Source
object-
_link: string
_link
-
deviceId: string
Maximum Length:
12The device related to the service order field activity (if applicable).
Nested Schema : items
Type:
Show Source
object-
deviceTypeDescription: string
Maximum Length:
60Description of the type of deviceExample:10K mercury vapor -
numberInstalled: number
Minimum Value:
0Maximum Value:99999Number of unbadged item(s) with an effective installation as of the current date.Example:1
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.