{
  "name": "Traffic balance API",
  "description": "Read-only traffic balance for a single account. Every caller sees only their own account, and no credentials are ever included in a response.",
  "endpoints": {
    "GET /residential/users/{uuid}?token=…": "Balance for one account. The signed token is issued by the operator and pinned to that uuid. `Authorization: Bearer <token>` works too.",
    "POST /residential/users/{uuid}": "Balance authenticated by the account's package password: JSON body {\"password\":\"…\"} (or an x-package-password header). Only the package matching that password is returned.",
    "GET /health": "Liveness probe."
  },
  "units": "All *_gb fields are gigabytes (1 GB = 1024^3 bytes)."
}