---
title: "Fair-use bandwidth usage for the calendar month"
method: GET
path: "/account/egress"
tags: ["Account"]
---

# Fair-use bandwidth usage for the calendar month

`GET /account/egress`

## Request

- Base URL: `https://api.percher.run`
- URL: `https://api.percher.run/account/egress`
- Auth: HTTP bearer

Bytes served by every app the account owns this UTC month (all route kinds), the plan allowance plus any operator override, the percentage, and the cap state (`ok` | `warned` | `exceeded` | `lifted`). `capBytes`/`percent` are null for exempt accounts. `resetsAt` is when an `exceeded` block lifts on its own. Optional `?month=YYYY-MM` reads history.

## Query parameters

- `month` string

## Response `200`

Egress summary

## Other responses

- `401`: Unauthorized

---

[API](https://skmtc.dev/percher/apis/percher-api.md) · [All operations](https://skmtc.dev/percher/apis/percher-api/llms.txt) · [OpenAPI document](https://skmtc.dev/percher/apis/percher-api/revisions/d9e7089c21e5?raw)