ghtier
← All permissions
Enterprise permission·enterprise_billing:read

Enterprise billing: Read

Tier 3 · Low

Why Tier 3

Reads billing usage and budgets.

Data plane permissions start at Tier 2. This one is lowered for the reason above.

Target
Enterprise
Plane
DataInsights and billing: Metrics, events, usage, billing and licensing.
Granted by
GitHub App
Available on
Enterprise Cloud, EMU

What it unlocks

12 REST endpoints need this permission. A few of them:

  • GET /enterprises/{enterprise}/settings/billing/ai_credit/usage
  • GET /enterprises/{enterprise}/settings/billing/budgets
  • GET /enterprises/{enterprise}/settings/billing/budgets/{budget_id}
  • GET /enterprises/{enterprise}/settings/billing/budgets/{budget_id}/user-states

Roles that include it

No built-in role includes it. Only tokens, Apps or custom roles can grant it.

Classic scopes that reach it

No classic scope reaches it. Only fine-grained PATs, Apps or GITHUB_TOKEN can grant it.

Attack paths

No attack technique, escalation or incident on ghtier goes through this yet.

Other levels

GitHub Docs: Enterprise permissions for "Enterprise billing"