Retrieve Service Points Info corresponding to a Premise
get
/rest/apis/customer/v-model/servicePointSearch/{premiseId}/getServicePointsInfoForPremise
Request
Path Parameters
-
premiseId(required): string
Premise ID is a system-assigned, unique identifier for the primary premise associated with the service agreement.Example:
3364881208
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : C1PremToSPs
Type:
Show Source
object
-
limit: number
Minimum Value:
0
Maximum Value:999999999.999999
Limit determines the page size, or maximum number of results, of the search query.Example:20
-
offset: number
Minimum Value:
0
Maximum Value:999999999.999999
Offset determines the starting point of results to return for the search query.Example:0
-
servicePointList: array
servicePointList
-
totalNumberOfRecords: number
Minimum Value:
0
Maximum Value:99999
The total number of records returned in a service point search.Example:3
Nested Schema : items
Type:
Show Source
object
-
abolishedDate: string
(date)
Date when service point was abolished (if applicable).
-
badgedDevice: object
badgedDevice
-
installationDate: string
(date)
The installation date for a service point.
-
isMetered: boolean
Indicates a service point sub type as a metered service point when defined as true. A value of false indicates that the service point is not metered.Example:
true
-
servicePointDescription: string
Allowed Values:
[ "I ", "R " ]
Description for Service Point. * `I ` - Out of Service, * `R ` - In Service -
servicePointId: string
Maximum Length:
10
Service Point ID is a system assigned random number that defines a service point record. -
servicePointTypeDescription: string
Maximum Length:
150
Description for Service Point Type.Example:Electric Residential Main
-
serviceType: string
Maximum Length:
80
Service Type defines the type of service associated with the Service Agreement type.Example:E
-
serviceTypeDescription: string
Maximum Length:
60
The description for the service type that can be displayed to customers.Example:Electric
-
sourceStatusDescription: string
Allowed Values:
[ "C ", "D " ]
A description or label of the service point source status. * `C ` - Connected, * `D ` - DisconnectedExample:Connected
-
timeZoneName: string
Maximum Length:
50
The description of the time zone that can be displayed to customers. -
unbadgedDevices: array
unbadgedDevices
Nested Schema : badgedDevice
Type:
Show Source
object
-
badgeNumber: string
Maximum Length:
30
Badge Number is the identifier stamped on the meter. This is NOT the manufacturer's serial number.Example:32505964
-
deviceInfo: string
Maximum Length:
150
Relevant information about the device.Example:10K mercury vapor / L029 / SKS-029 - Active
-
deviceInstallationDateTime: string
(date-time)
The installation date and time for a service point device.Example:
2004-04-21T00:00:00-07:00
-
deviceStatus: string
Maximum Length:
4
The status of a device.Example:on
-
deviceTypeDescription: string
Maximum Length:
100
The general description or label for a device type.Example:10K mercury vapor
Nested Schema : items
Type:
Show Source
object
-
startDateTime: string
(date-time)
Start date and time for unbadged item(s) at the service point.Example:
1998-01-01T00:00:00-08:00
-
unbadgedDevicesInfo: array
unbadgedDevicesInfo
Nested Schema : items
Type:
Show Source
object
-
deviceTypeDescription: string
Maximum Length:
100
The general description or label for a device type.Example:10K mercury vapor
-
numberInstalled: number
Minimum Value:
0
Maximum Value:99999
Number 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:
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.