Utilities
Southern Company logo

Southern Company API

customerservice2.southerncompany.com

Southern Company — download utility bills for Georgia Power, Alabama Power, and Mississippi Power. Log in, list statements, and download bill PDFs.

Actions
2
Category
Utilities
Login
Some actions
Output
JSON

Call the Southern Company API

Submit a task, then poll the job until it settles. This example runs sco_download_bill.

curl -X POST https://api.anakin.io/v1/wire/task \
  -H "X-API-Key: $ANAKIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "action_id": "sco_download_bill",
    "credential_id": "<your-credential-id>",
    "params": {
      "account_number": ""
    }
  }'

2 actions on customerservice2.southerncompany.com

Read

  • Southern Company Download Bill

    sco_download_billreadlogin required1 credit / call

    Download a Southern Company bill statement as a PDF, using the session from sco_login. Given an account_number and a bill_date (from sco_list_bills, or 'latest' for the most recent statement), it looks up the account's encrypted id, opco and account type, then fetches the PDF from /Bill/BillImage/ and returns the raw bytes via the runtime file-return contract (retrieve with GET /jobs/:id/download). The account-detail lookup uses the ScJwtToken bearer; the PDF endpoint is authenticated by the SouthernJwtCookie — both ride in the login cookie jar. US-only site — runs through a US residential proxy.

    account_number
    string · required
    bill_date
    string
  • Southern Company List Bills

    sco_list_billsreadlogin required1 credit / call

    List the available bills (statements) for a Southern Company account using the session from sco_login. Returns, per account, the bill_date (pass it to sco_download_bill), amount, service period, and an is_downloadable flag (mirrors the portal's IsBillImageAvailable — only downloadable bills have a PDF). Payment rows are excluded. Reads from customerservice2api.southerncompany.com with the ScJwtToken bearer carried in the login cookie jar. US-only site — runs through a US residential proxy.

    account_number
    string
    months
    integer

Southern Company API questions

Is there an API for Southern Company?
Southern Company does not offer a public data API for this, but Anakin Wire provides 2 maintained endpoints for customerservice2.southerncompany.com. You call Anakin's REST API with an action ID and parameters and get structured JSON back; Anakin handles the browser, proxies, anti-bot, and parsing.
How do I scrape Southern Company data?
POST to https://api.anakin.io/v1/wire/task with your API key, the action ID, and its parameters, then poll GET /v1/wire/jobs/{id} until the job settles. There is nothing to install and no scraper to maintain — when customerservice2.southerncompany.com changes its markup, Anakin updates the action.
Do I need a Southern Company account?
Some Southern Company actions read data that is only visible when signed in, so those need a credential you connect once. Actions marked "read" without a login requirement run anonymously.
What does the Southern Company API cost?
Usage-based credits, charged per call and refunded automatically when a job fails. New accounts start with 300 free credits and no card. See anakin.io/pricing for the current rates.