Retrieve SP Usage

post

/rest/apis/customer/v-model/servicePointsCommon/servicePointUsage

Request

There are no request parameters for this operation.

Supported Media Types
Request Body - application/xml ()
Root Schema : schema
Type: object
Show Source
  • Optional end date for requesting the service point usage data.
    Example: 2024-02-20
  • Allowed Values: [ "DELT", "GET ", "POST", "PTCH", "PUT " ]
    HTTP Method: * `DELT` - Delete, * `GET ` - Get, * `POST` - Post, * `PTCH` - Patch, * `PUT ` - Put
  • Maximum Length: 10
    Service Point ID
  • Optional start date for requesting the service point usage data.
    Example: 2023-01-10
  • Allowed Values: [ "C1YR", "X1DY", "X1MO" ]
    Time scale of usage data to that can be for a Year (monthly data), Month (daily data), or Day (hourly data). * `C1YR` - View Year, * `X1DY` - View Day, * `X1MO` - View Month
    Example: C1MO
  • Maximum Length: 30
    The input unit of measure of the usage data requested.
Request Body - application/json ()
Root Schema : schema
Type: object
Show Source
  • Optional end date for requesting the service point usage data.
    Example: 2024-02-20
  • Allowed Values: [ "DELT", "GET ", "POST", "PTCH", "PUT " ]
    HTTP Method: * `DELT` - Delete, * `GET ` - Get, * `POST` - Post, * `PTCH` - Patch, * `PUT ` - Put
  • Maximum Length: 10
    Service Point ID
  • Optional start date for requesting the service point usage data.
    Example: 2023-01-10
  • Allowed Values: [ "C1YR", "X1DY", "X1MO" ]
    Time scale of usage data to that can be for a Year (monthly data), Month (daily data), or Day (hourly data). * `C1YR` - View Year, * `X1DY` - View Day, * `X1MO` - View Month
    Example: C1MO
  • Maximum Length: 30
    The input unit of measure of the usage data requested.
Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : C1RetSPUsage
Type: object
Show Source
Nested Schema : usageDetails
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
Nested Schema : usagePeriod
Type: object
Show Source
Nested Schema : usage
Type: array
Show Source
Nested Schema : items
Type: object
Show Source
  • Maximum Length: 30
    Service quantity identifiers provide additional classification of values when a combination of unit of measure and time of use is inadequate to uniquely classify the value. For example, the service quantity identifiers Consumed and Generated can distinguish between KWH Off-Peak Consumed and KWH Off-Peak Generated.
  • Maximum Length: 30
    The time-of-use classification of the usage value.
    Example: ON
  • 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-
  • Minimum Value: 0
    Maximum Value: 9999.999999
    The usage value for the corresponding identifier.
    Example: 7.75

400 Response

Bad Request
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • 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.
  • 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
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.

500 Response

Internal Server Error
Body ()
Root Schema : problemDetailDocument
Type: object
Show Source
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 9999
    The HTTP Status code for the error.
  • 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.
  • 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
  • Maximum Length: 60
    The stack trace shows where the error occurs during the execution of a program.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
Nested Schema : serverMessage
Type: object
Show Source
  • Maximum Length: 60
    Delimited sequence of programs called.
  • Maximum Length: 60
    The long message description from the Oracle Utilities Application Framework in CDATA format.
  • Minimum Value: 0
    Maximum Value: 0
    Message Category within Oracle Utilities Application Framework.
  • Minimum Value: -99999
    Maximum Value: 99999
    Message Number within Oracle Utilities Application Framework.
  • Maximum Length: 60
    Fully qualified error message from Oracle Utilities Application Framework in CDATA format.
  • Maximum Length: 60
    Name of the program that encountered the error.
Back to Top