Southern Company · Schema

Southern Company Energy Usage

Daily or interval energy consumption data for a Southern Company utility account, measured in kilowatt-hours (kWh) for electric service or therms for natural gas service.

Fortune 500Electric UtilityNatural GasEnergy

Properties

Name Type Description
accountNumber string The utility account number associated with this usage data.
usageDate string The date for which usage is reported (YYYY-MM-DD).
usageKwh number Energy consumption in kilowatt-hours for electric service.
usageTherms number Energy consumption in therms for natural gas service.
peakDemandKw number Peak demand in kilowatts recorded during the usage period.
estimatedCost number Estimated cost in US dollars for the recorded usage.
readType string Indicates whether the reading was actual (metered), estimated, or customer-reported.
intervalMinutes integer The interval length in minutes for interval data (15-min, 30-min, hourly, or daily).
temperature number Average outdoor temperature in degrees Fahrenheit for the usage period.
View JSON Schema on GitHub

JSON Schema

southern-energy-usage-schema.json Raw ↑
{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://api-evangelist.github.io/southern/json-schema/southern-energy-usage-schema.json",
  "title": "Southern Company Energy Usage",
  "description": "Daily or interval energy consumption data for a Southern Company utility account, measured in kilowatt-hours (kWh) for electric service or therms for natural gas service.",
  "type": "object",
  "properties": {
    "accountNumber": {
      "type": "string",
      "description": "The utility account number associated with this usage data."
    },
    "usageDate": {
      "type": "string",
      "format": "date",
      "description": "The date for which usage is reported (YYYY-MM-DD)."
    },
    "usageKwh": {
      "type": "number",
      "description": "Energy consumption in kilowatt-hours for electric service.",
      "minimum": 0
    },
    "usageTherms": {
      "type": "number",
      "description": "Energy consumption in therms for natural gas service.",
      "minimum": 0
    },
    "peakDemandKw": {
      "type": "number",
      "description": "Peak demand in kilowatts recorded during the usage period.",
      "minimum": 0
    },
    "estimatedCost": {
      "type": "number",
      "description": "Estimated cost in US dollars for the recorded usage.",
      "minimum": 0
    },
    "readType": {
      "type": "string",
      "enum": ["Actual", "Estimated", "Customer"],
      "description": "Indicates whether the reading was actual (metered), estimated, or customer-reported."
    },
    "intervalMinutes": {
      "type": "integer",
      "enum": [15, 30, 60, 1440],
      "description": "The interval length in minutes for interval data (15-min, 30-min, hourly, or daily)."
    },
    "temperature": {
      "type": "number",
      "description": "Average outdoor temperature in degrees Fahrenheit for the usage period."
    }
  },
  "required": ["accountNumber", "usageDate"]
}

Work with this as data

Every JSON Schema here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for schemas

4 MCP tools reach this
  • find_json_schemasBrowse and filter every JSON Schema in the catalog.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools

Call it yourself

curl for this page
This JSON Schema
curl "https://apis.io/api/v1/json-schemas/southern-energy-usage"
All schemas
curl "https://apis.io/api/v1/json-schemas?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

A second provider on the same verified email joins the account you already have.