Get Service Point Reading Details
get
/rest/apis/customer/v-model/servicePointsCommon/{servicePointId}/servicePointReadingDetails
This operation retrieves billed readings for a service point and date range.
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:
50The description for the time zone that is displayed to customers.Example:US/Pacific -
hasMore: boolean
Has MoreExample:
false -
limit: number
Minimum Value:
0Maximum Value:999999999.999999Limit 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:
0Maximum Value:999999999.999999Offset determines the starting point of results to return for the search query.Example:0 -
premiseTimeZone: string
Maximum Length:
10The Olson timezone name as defined in the Utility's installation setting that indicates when the usage occurred.Example:USPACIFIC -
servicePointId: string
Maximum Length:
10Service 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:
0Maximum Value:99999The total number of records returnedExample:3
Nested Schema : items
Type:
Show Source
object-
billSegmentId: string
Maximum Length:
12The 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:
0Maximum Value:0End Register Reading is the end register reading.Example:11578.000000 -
finalSqi: string
Maximum Length:
30Final Service Quantity Identifier for the quantity. -
finalTou: string
Maximum Length:
30Final Time of Use code of the reading.Example:ON -
finalUom: string
Maximum Length:
30Final 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:
-1000000000000Maximum Value:1000000000000Multiplier is the composite multiplier that converts the measured quantity to the registered quantity.Example:1.000000 -
quantity: number
Minimum Value:
0Maximum Value:1000000000000Measured quantity since the previous reading.Example:208.000000 -
readSeq: number
Minimum Value:
-99999Maximum Value:99999SequenceExample: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:
100An 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:
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.