Turn T-Mobile for Business Account Hub into an API

What you can build on Account Hub

• Get usage and out-of-plan charges by line

  Build this

  Reads the Usage tab on the Billing page for one account and billing period, with talk time, text, data used and out-of-plan charges for each line.

  Takes

  Account number, billing period (optional)

  Returns

  Billing period, phone number, talk time, texts, data used, out-of-plan charges

• Get lines with zero usage

  Build this

  Runs the Zero Usage report on the Reports tab of Reporting for a billing period and hierarchy level, and reads the lines with no usage.

  Takes

  Billing period, hierarchy level

  Returns

  Account number, phone number, usage categories with no usage, billing periods

• Get active features by line

  Build this

  Runs the Feature SOC report on the Reports tab of Reporting and reads the active features on each line, with their descriptions.

  Takes

  Billing period, hierarchy level

  Returns

  Account number, phone number, feature SOC, feature description

• Suspend or restore a line

  Build this

  Selects lines on the Manage Lines tab of Manage Accounts, chooses Suspend or Restore, submits the change and reads the transaction number.

  Takes

  Account number, phone numbers, suspend or restore, reason, start and end dates

  Returns

  Phone numbers, action, reason, dates, transaction number

Automate Account Hub with a workflow

A workflow runs your methods as one process, with nobody at the screen. A schedule or a call from your own system starts it, the steps run in order, and the result arrives in your inbox or in the systems you already use.

• Lines with zero usage, after each bill cycle

  Build this

  Starts

  Monthly, at least six days after your bill cycle closes

  Step 1

  Get the lines in the Zero Usage report for the last billing period, at your company's hierarchy level.

  Step 2

  Keep the lines that were not in the report on the last run.

  Step 3

  Email you the list with account number, phone number and the categories with no usage.

• Out-of-plan charges, every account

  Build this

  Starts

  Every Monday at 8:00

  Step 1

  For each account you name, get usage and out-of-plan charges by line for the current billing period.

  Step 2

  Keep the lines with out-of-plan charges above zero.

  Step 3

  Post account number, phone number, data used and out-of-plan charges to your webhook.

• Feature changes on lines since last month

  Build this

  Starts

  Monthly, at least six days after your bill cycle closes

  Step 1

  Get active features by line from the Feature SOC report for the last billing period.

  Step 2

  Keep the features that were added or removed since the last run.

  Step 3

  Email you the changes, grouped by account.

You can run a workflow by hand on every plan, Free included. Schedules and webhook triggers come with the paid plans, from $29 a month.

Once built, one call from your code

Once you have built a method, it is one POST to /v1/runs from your backend, or a tool an AI agent calls over MCP. This is what “Get usage and out-of-plan charges by line” would look like.

curl https://api.fous.com/v1/runs \
  -H "Authorization: Bearer $FOUS_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tfb.t-mobile.com/get_usage_by_line",
    "input": {
      "account_number": "961234570",
      "billing_period": "Oct 12 - Nov 11, 2026"
    }
  }'

{
  "status": "completed",
  "data": {
    "account_number": "961234570",
    "billing_period": "Oct 12 - Nov 11, 2026",
    "lines": [
      {
        "phone_number": "(555) 010-4821",
        "talk_minutes": 812,
        "texts": 1460,
        "data_used_gb": 18.4,
        "out_of_plan_charges": 0
      }
    ],
    "currency": "USD",
    "count": 1
  }
}

An example with invented data, not a ready-made endpoint. The method exists in your organization once you build it, and its name, inputs and fields follow your request.

Account Hub’s own options

T-Mobile's Account Hub support pages describe bill files and scheduled reports, not an API for accounts or lines. Some bill formats can get EDI files, the TFB1 bill format can get Data Direct files, and reports can be subscribed to. Orders, line changes and suspensions are done in Account Hub itself.

Read on November 12, 2026: Electronic Data Interchange (EDI), Data Direct, Account Hub reporting.

Signing in to Account Hub

Account Hub signs you in with a T-Mobile ID and password, and Google Authenticator can be added as a second step. Your role decides which accounts and lines you see: Business Owner, Account Manager or End User. With Fous you sign in once through Account Hub's own sign-in with your own account: the login is sealed with AES-256, and code and AI agents never see it.

Worth knowing

Billing data settles six days after close

T-Mobile asks for report dates at least six days after the bill cycle close date, while the billing system reconciles charges. Billing reports change only once the monthly bill cycle is complete.

Bills and reports are made on request

A summary PDF bill can take up to two hours to download and a detailed one up to 12 hours. Account size, hierarchy level and data points affect how long a report takes, and reports are deleted 15 days after creation.

Your role limits what a method can do

End Users reach only the lines assigned to them, and Account Managers only their assigned accounts, sometimes with approval needed. Suspend, restore and service changes return a transaction number in Transaction History.

Cancelling a line is not in Account Hub

Lines can be suspended and restored in Account Hub, but T-Mobile asks you to call Customer Care to cancel one. A Lost/Stolen suspend becomes a permanent cancellation if the line is not restored within 30 days.

More in Telecom and IT channel

• AT&T Premier
• Verizon My Business
• AT&T Business Center
• Verizon Enterprise Center
• TD SYNNEX ECExpress
• Cisco Commerce Workspace

Other industries: GreenSky merchant portal, Basware Portal, Comarch ERP Optima, 微信公众平台, AutoZonePro, GM GlobalConnect.