(GET) Customer Info | Calculate APIs

Description

Stage (test): https://pge-pe-api.gridx.com/stage/v1/customer/info

Production: https://pge-pe-api.gridx.com/v1/customer/info

The getCustomer Info API provides customer information about that customer and account based on the requested customer information.

Response	Definition
contractID	the customer’s electric “service agreement id”
customerUuid	a unique identifier for customer ID
meterAccountID	the customer’s electric “service point ID”
rateCode	customer’s rate
voltageClass	customer’s voltage class (primary, secondary, or transmission)
rateCodeHasVoltageClass	true or false, not all rate codes have voltage classes
representativeCircuitID	representative circuit ID the customer is on in utility’s territory
hasCCA	true or false, not all customers have a CCA
CCA	if the customer has an agreement with a CCA to deliver generation data, the name of the CCA will be returned

Headers

Parameter	Description
Authorization	JWT token received from /token endpoint, more information here: https://api-calculate-docs.gridx.com/acgd/post-token-authentication
X-Contract-Id	Base64-encoded contract ID for the customer, Contract IDs (aka Service Point IDs) are 10 digits and must include leading zero’s.
X-Customer-Uuid	Base64-encoded UUID for the customer

Note* ContractID (aka service agreement ID) and UUID must be base64-encoded. The token request will expire after an hour. Here is a tool to get the encoded values: https://www.base64encode.org/

Example

Sample JSON Request

Bash

curl --location 'https://pge-pe-api.gridx.com/stage/v1/customer/info' \
--header 'Authorization: Bearer eyJraWQiOiJjMFVubE52MHdoRGUwdEY0Ujlndk1PSks4QURkZ3RuUjY0S0VENisxZDhBPSIsImFsZyI6IlJTMjU2In0.eyJzdWIiOiIyNXBmZzVpYTBqMnE2cG5qbm9tYmVpMGkzbCIsInRva2VuX3VzZSI6ImFjY2VzcyIsInNjb3BlIjoiUHJpY2luZ0VuZ2luZVwvQkwiLCJhdXRoX3RpbWUiOjE3MzM3NjY0OTUsImlzcyI6Imh0dHBzOlwvXC9jb2duaXRvLWlkcC51cy13ZXN0LTIuYW1hem9uYXdzLmNvbVwvdXMtd2VzdC0yX0NyVENlc0pYNSIsImV4cCI6MTczMzc3MDA5NSwiaWF0IjoxNzMzNzY2NDk1LCJ2ZXJzaW9uIjoyLCJqdGkiOiI1MmYwYmY4My04NTkzLTRkZTctOWNjOC01NmIwMWQ4YzBkMDUiLCJjbGllbnRfaWQiOiIyNXBmZzVpYTBqMnE2cG5qbm9tYmVpMGkzbCJ9.Lhzn6eIudKiifKh-jUS46RQi2VULI7TFVMXsIBAQTMjvGktGmtifXt1qRbtwSPnhtTNblaxm_bp5mZmlCoLLQ2elKoPftQj1iXB3v2FYTW_iGlWXrUzEzV6EuTWNZ31ma4lCgos9zKzJGCkvTb6NVwSJYqR1fvzLY06w-8ECIukFSXoKUW5OKExYbYxtXDk_d_amgLxhlv4XqkkTwlLaU9LgP1VB6KNOA_Ps4JxiIqM0w0al044ZEyAZ7v7iZPY9zJnFAw4lP7hHhzxdpMZESPxI_Ec3TMF3mYwIQ6OJuMUOPUySsiOApVOIauXk-5sJs4nOjK8X-Mz9ZGqJIgHldQ' \
--header 'X-Contract-Id: MTIzNDU2Nzg5MA==' \
--header 'X-Customer-Uuid: MTIzNDU2Nzg5MA=='

Sample JSON Response

JSON

{
    "contractId": "1234567890",
    "customerUuid": "1234567890",
    "meterAccountId": "1234567890",
    "rateCode": "HBEV2",
    "rateCodeHasVoltageClass": false,
    "circuitId": "012091112",
    "hasCca": true,
    "cca": "EBCE-WB-S"
}