Get Service Point Summary

get

/rest/apis/customer/v-model/servicePointsCommon/{servicePointId}/summary

Request

Path Parameters

There's no request body for this operation.

Back to Top

Response

Supported Media Types

200 Response

Success response
Body ()
Root Schema : C1SPSummary
Type: object
Show Source
  • _self
  • This is the date of the abolishment of the service point at the premise.
  • c2mFields
  • Minimum Value: -99999
    Maximum Value: 99999
    Route Description
    Example: 210
  • Maximum Length: 100
    Description of the location of the service point at the premise.
    Example: Left side of house
  • Maximum Length: 100
    If the service point source status is disconnected, use Disconnect Location to specify where service was severed.
    Example: Transformer - Electric
  • Maximum Length: 5
    CIS Division is used to define the jurisdiction in which the premise is located if the premise type allows CIS Division. The default value is based on the Country and the Postal Code, but can be overridden.
    Example: Ohio
  • Has Equipment indicates if any equipment is linked to the service point. A value of true indicates that there is equipment linked to the service point.
    Example: false
  • Has Multi Items indicates a service point with multiple non-badged items. A value of true indicates that there are multiple non-badged items for the service point.
    Example: false
  • This is the date of the installation of the service point at the premise.
    Example: 2018-08-24
  • Maximum Length: 100
    Instruction Details provides more detailed instructions to the individual who reads meters at this premise.
    Example: Verify serial number
  • Is Active indicates if the service point is In Service or Abolished. A value of true defines the service point as active.
    Example: true
  • Is Connected defines if the service point is connected to the source of service or not. A value of true defines the service point as connected.
    Example: true
  • Define Key at Premise as true if the meter is secured in a locked area and your company has the key. If this field is turned on, you may also specify the Key ID.
    Example: true
  • Maximum Length: 10
    Key Id defines the key identifier if Key at Premise field is enabled.
    Example: 12345
  • Maximum Length: 4000
    Meter Location is used to define where the service point is located on the premise.
    Example: Location Details added in SP Live Data
  • Maximum Length: 150
    Description for the service point's measurement cycle.
    Example: ZZT Monthly meter rd cycle - day 1 (M-D1)
  • Maximum Length: 250
    MR Instruction defines specific instructions that are provided to the person who reads the meter. Meter read instructions and warnings are downloaded as part of the meter read download.
    Example: CON
  • Define OK to Enter as true if the meter is located in the interior of the premise and your company has permission to enter.
    Example: true
  • premise
  • Maximum Length: 150
    Description for the Measurement Cycle Route.
    Example: MV90 Route 1
  • Maximum Length: 10
    Service Point ID
  • servicePointType
    The Service Point Type defines the types of service points that are available. For example, G-COM is configured as "Gas Commercial" and controls the types of devices that can be installed.
  • Maximum Length: 50
    The description for the time zone that is displayed to customers.
    Example: US/Pacific
  • Maximum Length: 100
    MR Warning Description defines a specific warning that is provided to the person who reads the meter. Meter read instructions and warnings are downloaded as part of the meter read download.
    Example: Mean dog at premise
Nested Schema : c2mFields
Type: object
Show Source
Nested Schema : premise
Type: object
Show Source
Nested Schema : servicePointType
Type: object
The Service Point Type defines the types of service points that are available. For example, G-COM is configured as "Gas Commercial" and controls the types of devices that can be installed.
Show Source
  • Maximum Length: 4
    The Service Point Type defines the types of service points that are available. For example, G-COM is configured as "Gas Commercial" and controls the types of devices that can be installed.
    Example: G-COM
  • Maximum Length: 30
    The Service Point Type defines the types of service points that are available. For example, G-COM is configured as "Gas Commercial" and controls the types of devices that can be installed.
    Example: G-COM
  • Maximum Length: 150
    The Service Point Type defines the types of service points that are available. For example, G-COM is configured as "Gas Commercial" and controls the types of devices that can be installed.
    Example: G-COM
  • Maximum Length: 80
    The Service Point Type defines the types of service points that are available. For example, G-COM is configured as "Gas Commercial" and controls the types of devices that can be installed.
    Example: G-COM
Nested Schema : mainContact
Type: object
Show Source

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