UGI Corporation · Schema

UGI Energy Account

Schema for a UGI utility customer account with service and billing information.

EnergyUtilitiesNatural GasPropaneElectricFortune 500Pennsylvania

Properties

Name Type Description
accountNumber string Unique UGI account identifier.
customerName string Full name of the account holder.
serviceAddress object Service delivery address.
serviceType string Type of energy service.
meterNumber string Meter identifier at the service address.
accountStatus string Current account status.
billingSummary object Current billing information.
usageSummary object Recent energy usage summary.
View JSON Schema on GitHub

JSON Schema

ugi-energy-account-schema.json Raw ↑
{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "$id": "https://github.com/api-evangelist/ugi/blob/main/json-schema/ugi-energy-account-schema.json",
  "title": "UGI Energy Account",
  "description": "Schema for a UGI utility customer account with service and billing information.",
  "type": "object",
  "properties": {
    "accountNumber": {
      "type": "string",
      "description": "Unique UGI account identifier."
    },
    "customerName": {
      "type": "string",
      "description": "Full name of the account holder."
    },
    "serviceAddress": {
      "type": "object",
      "description": "Service delivery address.",
      "properties": {
        "street": { "type": "string" },
        "city": { "type": "string" },
        "state": { "type": "string" },
        "zipCode": { "type": "string" }
      }
    },
    "serviceType": {
      "type": "string",
      "enum": ["natural_gas", "electric", "propane"],
      "description": "Type of energy service."
    },
    "meterNumber": {
      "type": "string",
      "description": "Meter identifier at the service address."
    },
    "accountStatus": {
      "type": "string",
      "enum": ["active", "inactive", "pending", "suspended"],
      "description": "Current account status."
    },
    "billingSummary": {
      "type": "object",
      "description": "Current billing information.",
      "properties": {
        "amountDue": { "type": "number", "description": "Amount due in USD." },
        "dueDate": { "type": "string", "format": "date" },
        "lastPaymentAmount": { "type": "number" },
        "lastPaymentDate": { "type": "string", "format": "date" }
      }
    },
    "usageSummary": {
      "type": "object",
      "description": "Recent energy usage summary.",
      "properties": {
        "currentReading": { "type": "number" },
        "previousReading": { "type": "number" },
        "usage": { "type": "number" },
        "usageUnit": {
          "type": "string",
          "enum": ["CCF", "MCF", "kWh", "gallons"],
          "description": "Unit of energy measurement."
        },
        "billingPeriodStart": { "type": "string", "format": "date" },
        "billingPeriodEnd": { "type": "string", "format": "date" }
      }
    }
  }
}