---
title: "Read account usage and plan screen model"
method: GET
path: "/account/usage"
---

# Read account usage and plan screen model

`GET /account/usage`

## Request

- Base URL: `https://api.eurobase.dev`
- URL: `https://api.eurobase.dev/account/usage`
- Auth: HTTP bearer

Returns one coherent monthly snapshot containing account meters, resource contributors, projection freshness, and a separate UTC-day action-quota projection. When organizationId is supplied, plan resolution is organization-exclusive and never falls back to the requesting user subscription.

## Query parameters

- `organizationId` string
- `billingMonth` string

## Response `200`

Account usage summary with recorded values and projection status

- AccountUsageResponse
  - `plan` object, required
    - `code` string, required
    - `name` string, required
    - `pricingVersion` string, nullable, required
  - `scope` object, required
    - `kind` 'user' | 'organization', required
    - `organizationId` string, nullable, required
    - `userId` string, nullable, required
  - `period` UsageWindow, required
    - `code` 'current_month' | 'billing_month', required
    - `start` string, date-time, required
    - `end` string, date-time, required
  - `lastUpdatedAt` string, date-time, required
  - `status` 'available' | 'empty' | 'unavailable', required
  - `meters` object[], required
    - `code` string, required
    - `label` string, required
    - `unit` string, required
    - `value` string, required
    - `used` string, required
    - `reserved` string: Build seconds held for builds in progress, separate from consumed usage.
    - `limit` string, nullable, required
    - `resetAt` string, date-time, nullable, required
    - `state` 'ok' | 'blocked' | 'unavailable', required
    - `recoveryActions` string[], required
  - `runtimeUsage` object, nullable, required
    - `label` string, required
    - `usedSmallEquivalentHours` string, required
    - `includedSmallEquivalentHours` string, required
    - `remainingSmallEquivalentHours` string, required
    - `state` 'ok' | 'blocked', required
    - `sourceMeters` string[], required
    - `resetStrategy` string, required
  - `estimatedCost` EstimatedCost, required
    - `currency` 'EUR', required
    - `amount` string, required
    - `label` string, required
    - `pricingVersion` string, required
  - `billingState` BillingUsageState, required
    - `state` 'Estimated' | 'Finalizing' | 'Final', required
    - `label` string, required
    - `meterAvailability` 'available' | 'unavailable', required
    - `billingMonth` string, nullable, required
  - `billingSubscription` BillingSubscriptionState, required
    - `state` 'free' | 'granted' | 'processing' | 'active' | 'canceling' | 'past_due' | 'unpaid' | 'canceled', required
    - `label` string, required
    - `planCode` 'free' | 'starter' | 'pro' | 'null', nullable, required
    - `currentPeriodEnd` string, date-time, nullable, required
    - `cancelAtPeriodEnd` boolean, required
    - `manageBillingAvailable` boolean, required
  - `actionQuotas` AccountActionQuota[], required
    - `actionCode` 'deploy', required
    - `metricCode` 'deployments', required
    - `label` string, required
    - `used` string, required
    - `limit` string, required
    - `resetAt` string, date-time, required
    - `state` 'available' | 'blocked', required
    - `plan` object, required
      - `code` string, required
      - `name` string, required
      - `pricingVersion` string, nullable, required
    - `recoveryActions` string[], required
  - `resourceContributors` AccountUsageResourceContributor[], required
    - `projectId` string, required
    - `projectName` string, required
    - `resourceType` string, required
    - `resourceLabel` string, required
    - `meter` UsageMeterRow, required: Usage meter value returned by the API. Derived account meters such as runtime_average_latency_ms are computed by the API from DB-owned counters and are not accepted as persisted usage metrics.
      - `code` string, required
      - `label` string, required
      - `unit` string, required
      - `value` string, required
    - `estimatedCost` EstimatedCost, required
      - `currency` 'EUR', required
      - `amount` string, required
      - `label` string, required
      - `pricingVersion` string, required
    - `share` number, nullable, required
    - `updatedAt` string, date-time, nullable, required
  - `projection` object, required
    - `status` 'ready' | 'applying' | 'delayed' | 'rebuilding' | 'blocked' | 'unavailable', required
    - `asOf` string, date-time, required
    - `pendingCount` integer, required
    - `pendingCountIsLowerBound` boolean, required
    - `quarantinedCountIsLowerBound` boolean, required
    - `quarantinedCount` integer, required
    - `oldestPendingAt` string, date-time, nullable, required
    - `lagMs` integer, required

---

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