Get Service Point Reading Details
get
/rest/apis/customer/v-model/servicePointsCommon/{servicePointId}/servicePointReadingDetails
Request
Path Parameters
-
servicePointId(required): string
Service Point ID is a system assigned random number that stays with a service point record.Example:
5555400391
Query Parameters
-
endDate: string
Optional end date for requesting the service point usage data.Example:
2024-02-20
-
limit: number
Limit determines the page size, or maximum number of results, of the search query.Example:
20
-
offset: number
Offset determines the starting point of results to return for the search query.Example:
0
-
startDate: string
Optional start date for requesting the service point usage data.Example:
2023-01-10
There's no request body for this operation.
Back to TopResponse
Supported Media Types
- application/xml
- application/json
200 Response
Success response
Root Schema : C1SPReadDet
Type:
Show Source
object
-
billedReadings: object
billedReadings
-
endDate: string
(date)
Optional end date for requesting the service point usage data.Example:
2024-02-20
-
entityTimeZoneName: string
Maximum Length:
50
The description for the time zone that is displayed to customers.Example:US/Pacific
-
hasMore: boolean
Has MoreExample:
false
-
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
-
nextScheduledReadDate: string
(date)
Date of the next scheduled meter reading for the service point.Example:
12-03-2024
-
offset: number
Minimum Value:
0
Maximum Value:999999999.999999
Offset determines the starting point of results to return for the search query.Example:0
-
premiseTimeZone: string
Maximum Length:
10
The Olson timezone name as defined in the Utility's installation setting that indicates when the usage occurred.Example:USPACIFIC
-
servicePointId: string
Maximum Length:
10
Service Point ID is a system assigned random number that stays with a service point record.Example:5555400391
-
startDate: string
(date)
Optional start date for requesting the service point usage data.Example:
2023-01-10
-
totalNumberOfRecords: number
Minimum Value:
0
Maximum Value:99999
The total number of records returnedExample:3
Nested Schema : items
Type:
Show Source
object
-
billSegmentId: string
Maximum Length:
12
The system-assigned unique identifier of the bill segment. -
endReadDateTime: string
(date-time)
End Read Date/Time is the date and time of the end meter read.Example:
1998-09-30T00:00:00-04:00
-
endReading: number
Minimum Value:
0
Maximum Value:0
End Register Reading is the end register reading.Example:11578.000000
-
finalSqi: string
Maximum Length:
30
Final Service Quantity Identifier for the quantity. -
finalTou: string
Maximum Length:
30
Final Time of Use code of the reading.Example:ON
-
finalUom: string
Maximum Length:
30
Final Unit of Measure code of the reading.Example:KWH
-
isEstimate: boolean
If the Estimate switch is on, consumption on this bill segment has been estimated by the system.Example:
true
-
multiplier: number
Minimum Value:
-1000000000000
Maximum Value:1000000000000
Multiplier is the composite multiplier that converts the measured quantity to the registered quantity.Example:1.000000
-
quantity: number
Minimum Value:
0
Maximum Value:1000000000000
Measured quantity since the previous reading.Example:208.000000
-
readSeq: number
Minimum Value:
-99999
Maximum Value:99999
SequenceExample:1
-
readType: string
Allowed Values:
[ "20 ", "30 ", "35 ", "40 ", "45 ", "50 ", "60 ", "70 ", "80 " ]
Read Type of the meter reading. * `20 ` - No Read, * `30 ` - System Estimate, * `35 ` - Service Provider Estimate, * `40 ` - Office Estimate, * `45 ` - System Prorate, * `50 ` - Customer Read, * `60 ` - Regular, * `70 ` - Verified, * `80 ` - Billing ForceExample:60
-
usageIdentifier: string
Maximum Length:
100
An identifier for the usage value, provided in the format of KWH--(Unit of Measure-Time of Use-Service Quantity Identifier), with blank values represented with the dash character '-'.Example:KWH-ON-
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.