Southern Company · Schema

Southern Company Utility Account

Represents a Southern Company (Alabama Power, Georgia Power, Mississippi Power) utility customer account with associated service address, metering, and billing data.

Fortune 500Electric UtilityNatural GasEnergy

Properties

Name	Type	Description
accountNumber	string	Unique identifier for the utility account.
accountName	string	Name associated with the utility account (customer or business name).
subsidiary	string	The Southern Company subsidiary providing service for this account.
serviceAddress	object	The physical address where utility service is delivered.
meterNumber	string	Unique identifier for the utility meter at the service address.
serviceType	string	Type of utility service provided.
rateSchedule	string	The regulatory rate tariff code applied to this account (e.g., RS-9, GS-8).
accountStatus	string	Current status of the utility account.
currentBalance	number	Current account balance in US dollars.
dueDate	string	Date by which the current balance is due.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/southern/json-schema/southern-utility-account-schema.json",
  "title": "Southern Company Utility Account",
  "description": "Represents a Southern Company (Alabama Power, Georgia Power, Mississippi Power) utility customer account with associated service address, metering, and billing data.",
  "type": "object",
  "properties": {
    "accountNumber": {
      "type": "string",
      "description": "Unique identifier for the utility account.",
      "example": "123456789"
    },
    "accountName": {
      "type": "string",
      "description": "Name associated with the utility account (customer or business name).",
      "example": "Jane Smith"
    },
    "subsidiary": {
      "type": "string",
      "enum": ["Alabama Power", "Georgia Power", "Mississippi Power", "Southern Company Gas"],
      "description": "The Southern Company subsidiary providing service for this account."
    },
    "serviceAddress": {
      "type": "object",
      "description": "The physical address where utility service is delivered.",
      "properties": {
        "street": { "type": "string" },
        "city": { "type": "string" },
        "state": { "type": "string" },
        "zipCode": { "type": "string" }
      },
      "required": ["street", "city", "state", "zipCode"]
    },
    "meterNumber": {
      "type": "string",
      "description": "Unique identifier for the utility meter at the service address."
    },
    "serviceType": {
      "type": "string",
      "enum": ["Electric", "Natural Gas"],
      "description": "Type of utility service provided."
    },
    "rateSchedule": {
      "type": "string",
      "description": "The regulatory rate tariff code applied to this account (e.g., RS-9, GS-8)."
    },
    "accountStatus": {
      "type": "string",
      "enum": ["Active", "Inactive", "Pending", "Disconnected"],
      "description": "Current status of the utility account."
    },
    "currentBalance": {
      "type": "number",
      "description": "Current account balance in US dollars.",
      "minimum": 0
    },
    "dueDate": {
      "type": "string",
      "format": "date",
      "description": "Date by which the current balance is due."
    }
  },
  "required": ["accountNumber", "accountName", "subsidiary", "serviceAddress", "serviceType"]
}