Search Outage Events
post
/rest/apis/customer/service/outageEvent/search
This operation returns outage events for a given account and person.
Request
There are no request parameters for this operation.
Supported Media Types
- application/xml
- application/json
Nested Schema : filters
Type:
Show Source
object
-
accountId: string
Maximum Length:
10
Account ID -
includeRecentlyRestored: boolean
This field indicates if recently restored outage events should be included in the results.
-
personId: string
Maximum Length:
10
An optional input filter to find outage events for the Person ID.
Nested Schema : filters
Type:
Show Source
object
-
accountId: string
Maximum Length:
10
Account ID -
includeRecentlyRestored: boolean
This field indicates if recently restored outage events should be included in the results.
-
personId: string
Maximum Length:
10
An optional input filter to find outage events for the Person ID.
Response
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : C1OutagSerch
Type:
Show Source
object
-
outageEvents: array
outageEvents
-
standardBaseTimeZoneName: string
Maximum Length:
50
The name of the time zone that is displayed to customers.Example:US/Pacific
Nested Schema : items
Type:
Show Source
object
-
completionDateTime: string
(date-time)
The completed restoration or cancellation time of the outage event.Example:
2025-02-07T12:00:00-08:00
-
estimatedRestorationDateTime: string
(date-time)
The estimated restoration time of the outage event.Example:
2025-02-07T12:00:00-08:00
-
eventState: string
The external outage management system sends the event state, which is mapped to a customizable lookup value. If the value exceeds four characters, the service uses the Java name attribute for mapping.Example:
NEW
-
eventStateDescription: string
Maximum Length:
256
The description for outage event status values available from the outage system.Example:New unacknowledged event
-
externalOutageId: string
Maximum Length:
254
The unique identifier of the outage event in the outage management system.Example:200234
-
externalSystem: string
Maximum Length:
30
The unique identifier of the outage management system reporting the outage information. This should be a valid reference to an external system record.Example:CCB-NMS integration
-
locations: array
locations
-
outageEventId: string
Maximum Length:
14
The unique system generated primary key of the outage event record. -
outageStatusType: string
Allowed Values:
[ "C1AC", "C1RR", "C1SC" ]
This field indicates if outage status is active or scheduled. * `C1AC` - Active, * `C1RR` - Recently Restored, * `C1SC` - ScheduledExample:C1AC
-
outageType: string
Allowed Values:
[ "C1PL", "C1UP" ]
The Outage Type specifies whether the outage was planned or not. * `C1PL` - Planned, * `C1UP` - UnplannedExample:C1PL
-
primaryCauseDescription: string
Maximum Length:
254
The language description for the primary cause of the outage event if available from the outage system. Typically, values can be selected from a configured list such as weather, environment, and so on.Example:Trouble Call
-
startDateTime: string
(date-time)
The recorded start date and time of the outage event.Example:
2025-02-06T02:00:00-08:00
-
updateDateTime: string
(date-time)
The last updated date and time of the outage event.
Nested Schema : items
Type:
Show Source
object
-
accountId: string
Maximum Length:
10
Account ID -
accountName: string
Maximum Length:
254
The Account Name stored as a characteristic. -
premiseId: string
Maximum Length:
10
The Premise ID associated with a service disruption caused by the outage event. -
premiseInfo: string
Maximum Length:
254
The information string for the premise that is used in the application. The content is controlled by a plug-in algorithm on the installation record.
400 Response
Bad Request
Root Schema : problemDetailDocument
Type:
Show Source
object
-
detail: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0
Maximum Value:9999
The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60
Fully 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:
60
URL 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:
60
The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object
-
callSequence: string
Maximum Length:
60
Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0
Maximum Value:0
Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999
Maximum Value:99999
Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60
Name of the program that encountered the error.
500 Response
Internal Server Error
Root Schema : problemDetailDocument
Type:
Show Source
object
-
detail: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
httpStatus: number
Minimum Value:
0
Maximum Value:9999
The HTTP Status code for the error. -
problemInstance: string
Maximum Length:
60
Fully 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:
60
URL 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:
60
The stack trace shows where the error occurs during the execution of a program. -
title: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type:
Show Source
object
-
callSequence: string
Maximum Length:
60
Delimited sequence of programs called. -
longDescription: string
Maximum Length:
60
The long message description from the Oracle Utilities Application Framework in CDATA format. -
messageCategory: number
Minimum Value:
0
Maximum Value:0
Message Category within Oracle Utilities Application Framework. -
messageNbr: number
Minimum Value:
-99999
Maximum Value:99999
Message Number within Oracle Utilities Application Framework. -
messageText: string
Maximum Length:
60
Fully qualified error message from Oracle Utilities Application Framework in CDATA format. -
programName: string
Maximum Length:
60
Name of the program that encountered the error.