---
title: "Get account usage"
method: GET
path: "/v1/usage"
tags: ["Accounts"]
---

# Get account usage

`GET /v1/usage`

## Response `200`

- AccountUsageResponse
  - `billingEstimate` UsageCostEstimate, required
    - `currency` 'USD', required
    - `currentMonthOverageUsdMicros` integer, required
    - `estimatedMonthlyTotalUsdMicros` integer, required
    - `lineItems` UsageCostLineItem[], required
      - `billableAmount` integer, required
      - `billingUnit` string, required
      - `billingUnitSize` integer, required
      - `currentMonthUsed` integer, required
      - `estimateBasis` 'current_month_usage_window' | 'current_storage_bytes_as_full_month', required
      - `estimatedUsdMicros` integer, required
      - `includedPerMonth` integer, nullable, required
      - `meter` string, required
      - `priceUsdMicrosPerBillingUnit` integer, nullable, required
      - `product` string, required
      - `rounding` 'prorated_to_micro_usd' | 'next_billing_unit', required
      - `usageUnit` string, required
    - `nextActions` string[], required
    - `paidOveragesEnabled` boolean, required
    - `plan` 'free' | 'pro', required
    - `subscriptionUsdMicrosPerMonth` integer, required
  - `limits` PlanLimits, required
    - `alwaysOnServices` integer, required
    - `apiTokens` integer, required
    - `buildCpuMillicores` integer, required
    - `buildDeployHooksPerAccountPerMinute` integer, required
    - `buildDeployHooksPerServicePerMinute` integer, required
    - `buildDiskMib` integer, required
    - `buildEnvVarSizeKib` integer, required
    - `buildEnvVars` integer, required
    - `buildMemoryMib` integer, required
    - `concurrentBuilds` integer, required
    - `cronTriggers` integer, required
    - `customDomains` integer, required
    - `dataTransferGib` integer, nullable, required
    - `kvBulkMutationKeys` integer, required
    - `kvBulkReadKeys` integer, required
    - `kvBulkRequestBytes` integer, required
    - `kvDeletesPerDay` integer, nullable, required
    - `kvDeletesPerMonth` integer, nullable, required
    - `kvKeySizeBytes` integer, required
    - `kvListsPerDay` integer, nullable, required
    - `kvListsPerMonth` integer, nullable, required
    - `kvMetadataSizeBytes` integer, required
    - `kvMinCacheTtlSeconds` integer, required
    - `kvNamespaces` integer, required
    - `kvOperationsPerWorkerInvocation` integer, required
    - `kvReadsPerDay` integer, nullable, required
    - `kvReadsPerMonth` integer, nullable, required
    - `kvSameKeyWritesPerSecond` integer, required
    - `kvStorageMib` integer, nullable, required
    - `kvStorageMibPerNamespace` integer, nullable, required
    - `kvValueSizeMib` integer, required
    - `kvWritesPerDay` integer, nullable, required
    - `kvWritesPerMonth` integer, nullable, required
    - `logEventSizeBytes` integer, required
    - `logEventsPerDay` integer, nullable, required
    - `logEventsPerMonth` integer, nullable, required
    - `logRetentionDays` integer, required
    - `maxBuildDurationSeconds` integer, required
    - `monthlyBuildMinutes` integer, required
    - `monthlyDeployments` integer, required
    - `objectStorageClassAOperationsPerMonth` integer, nullable, required
    - `objectStorageClassBOperationsPerMonth` integer, nullable, required
    - `objectStorageEgressBytesPerMonth` integer, nullable, required
    - `objectStorageMib` integer, nullable, required
    - `projects` integer, required
    - `queueBacklogBytes` integer, required
    - `queueBatchSize` integer, required
    - `queueBatchWaitSeconds` integer, required
    - `queueConcurrentConsumers` integer, required
    - `queueDelaySeconds` integer, required
    - `queueMaxRetries` integer, required
    - `queueMessageSizeBytes` integer, required
    - `queueOperationsPerDay` integer, nullable, required
    - `queueOperationsPerMonth` integer, nullable, required
    - `queueRetentionSeconds` integer, required
    - `queueSendBatchBytes` integer, required
    - `queueSendBatchMessages` integer, required
    - `queueThroughputMessagesPerSecond` integer, required
    - `queueUserBodySizeBytes` integer, required
    - `queueVisibilityTimeoutSeconds` integer, required
    - `queues` integer, required
    - `serviceBindingInvocationsPerRequest` integer, required
    - `sqliteDatabases` integer, required
    - `sqliteMaxBoundParameters` integer, required
    - `sqliteMaxColumnsPerTable` integer, required
    - `sqliteMaxImportMib` integer, required
    - `sqliteMaxLikeGlobPatternBytes` integer, required
    - `sqliteMaxRowBytes` integer, required
    - `sqliteMaxSqlFunctionArguments` integer, required
    - `sqliteMaxSqlStatementBytes` integer, required
    - `sqliteQueriesPerWorkerInvocation` integer, required
    - `sqliteQueryTimeoutSeconds` integer, required
    - `sqliteRowsReadPerDay` integer, nullable, required
    - `sqliteRowsReadPerMonth` integer, nullable, required
    - `sqliteRowsWrittenPerDay` integer, nullable, required
    - `sqliteRowsWrittenPerMonth` integer, nullable, required
    - `sqliteStorageMib` integer, required
    - `sqliteStorageMibPerDatabase` integer, required
    - `sqliteTimeTravelDays` integer, required
    - `sqliteTimeTravelRestoreOperationsPer10MinPerDatabase` integer, required
    - `stateAlarmDurationSeconds` integer, required
    - `stateClasses` integer, required
    - `stateCpuMsPerRequest` integer, required
    - `stateDurationGbSecondsPerDay` integer, nullable, required
    - `stateDurationGbSecondsPerMonth` integer, nullable, required
    - `stateInstances` integer, nullable, required
    - `stateKeyValueSizeMib` integer, required
    - `stateRequestsPerDay` integer, nullable, required
    - `stateRequestsPerMonth` integer, nullable, required
    - `stateSoftRequestsPerSecond` integer, required
    - `stateSqliteRowsReadPerDay` integer, nullable, required
    - `stateSqliteRowsReadPerMonth` integer, nullable, required
    - `stateSqliteRowsWrittenPerDay` integer, nullable, required
    - `stateSqliteRowsWrittenPerMonth` integer, nullable, required
    - `stateSqliteStorageMibPerAccount` integer, nullable, required
    - `stateSqliteStorageMibPerObject` integer, required
    - `stateWebsocketMessageMib` integer, required
    - `staticAssetFileSizeMib` integer, required
    - `staticAssetFilesPerVersion` integer, required
    - `staticAssetHeaderLineChars` integer, required
    - `staticAssetHeaderRules` integer, required
    - `staticAssetRedirectDynamicRules` integer, required
    - `staticAssetRedirectRuleChars` integer, required
    - `staticAssetRedirectStaticRules` integer, required
    - `staticAssetRedirectTotalRules` integer, required
    - `storageBucketManagementOperationsPerSecond` integer, required
    - `storageCustomDomainsPerBucket` integer, required
    - `storageKeySizeBytes` integer, required
    - `storageMetadataSizeBytes` integer, required
    - `storageMultipartUploadMaxMib` integer, required
    - `storageObjectMaxMib` integer, required
    - `storageObjects` integer, nullable, required
    - `storageSameKeyWritesPerSecond` integer, required
    - `storageSinglePartUploadMaxMib` integer, required
    - `storageUploadParts` integer, required
    - `supportTicketsPerDay` integer, required
    - `workerBindingsPerService` integer, required
    - `workerCompressedSizeMib` integer, required
    - `workerCpuMsPerMonth` integer, nullable, required
    - `workerCpuMsPerRequest` integer, required
    - `workerCronDurationSeconds` integer, required
    - `workerDefaultCpuMsPerRequest` integer, required
    - `workerEnvVarSizeKib` integer, required
    - `workerEnvVars` integer, required
    - `workerHttpDurationSeconds` integer, nullable, required
    - `workerInternalSubrequestsPerRequest` integer, required
    - `workerMemoryMib` integer, required
    - `workerOutgoingConnectionsPerRequest` integer, required
    - `workerQueueConsumerDurationSeconds` integer, required
    - `workerRequestBodySizeMib` integer, required
    - `workerRequestHeaderSizeKib` integer, required
    - `workerRequestsPerDay` integer, nullable, required
    - `workerRequestsPerMonth` integer, nullable, required
    - `workerResponseHeaderSizeKib` integer, required
    - `workerStartupTimeMs` integer, required
    - `workerSubrequestsPerRequest` integer, required
    - `workerUncompressedSizeMib` integer, required
    - `workerUrlSizeKib` integer, required
    - `workerWaitUntilSeconds` integer, required
    - `workerWebsocketMessageMib` integer, required
    - `workers` integer, required
  - `pricing` PlanPricing, required
    - `builds` BuildPricing, required
      - `includedMinutesPerMonth` integer, required
      - `minuteOverageUsdMicros` integer, nullable, required
    - `kv` KvPricing, required
      - `deleteOverageUsdMicrosPerMillion` integer, nullable, required
      - `includedDeletesPerMonth` integer, nullable, required
      - `includedListsPerMonth` integer, nullable, required
      - `includedReadsPerMonth` integer, nullable, required
      - `includedStorageMib` integer, required
      - `includedWritesPerMonth` integer, nullable, required
      - `listOverageUsdMicrosPerMillion` integer, nullable, required
      - `readOverageUsdMicrosPerMillion` integer, nullable, required
      - `storageOverageUsdMicrosPerGbMonth` integer, nullable, required
      - `writeOverageUsdMicrosPerMillion` integer, nullable, required
    - `logs` LogPricing, required
      - `eventOverageUsdMicrosPerMillion` integer, nullable, required
      - `includedEventsPerMonth` integer, nullable, required
    - `objectStorage` ObjectStoragePricing, required
      - `classAOverageUsdMicrosPerMillion` integer, nullable, required
      - `classBOverageUsdMicrosPerMillion` integer, nullable, required
      - `deleteOperationsFree` boolean, required
      - `egressFree` boolean, required
      - `egressOverageUsdMicrosPerTb` integer, nullable, required
      - `includedClassAOperationsPerMonth` integer, required
      - `includedClassBOperationsPerMonth` integer, required
      - `includedEgressBytesPerMonth` integer, required
      - `includedStorageMib` integer, required
      - `storageOverageUsdMicrosPerGbMonth` integer, nullable, required
    - `paidOveragesEnabled` boolean, required
    - `queues` QueuePricing, required
      - `egressFree` boolean, required
      - `includedOperationsPerMonth` integer, nullable, required
      - `operationOverageUsdMicrosPerMillion` integer, nullable, required
    - `sqlite` SqlitePricing, required
      - `egressFree` boolean, required
      - `includedRowsReadPerMonth` integer, nullable, required
      - `includedRowsWrittenPerMonth` integer, nullable, required
      - `includedStorageMib` integer, required
      - `rowsReadOverageUsdMicrosPerMillion` integer, nullable, required
      - `rowsWrittenOverageUsdMicrosPerMillion` integer, nullable, required
      - `storageOverageUsdMicrosPerGbMonth` integer, nullable, required
    - `state` StatePricing, required
      - `durationOverageUsdMicrosPerMillionGbSeconds` integer, nullable, required
      - `includedDurationGbSecondsPerMonth` integer, nullable, required
      - `includedRequestsPerMonth` integer, nullable, required
      - `includedSqliteRowsReadPerMonth` integer, nullable, required
      - `includedSqliteRowsWrittenPerMonth` integer, nullable, required
      - `includedSqliteStorageMib` integer, required
      - `requestOverageUsdMicrosPerMillion` integer, nullable, required
      - `sqliteRowsReadOverageUsdMicrosPerMillion` integer, nullable, required
      - `sqliteRowsWrittenOverageUsdMicrosPerMillion` integer, nullable, required
      - `sqliteStorageOverageUsdMicrosPerGbMonth` integer, nullable, required
    - `staticAssets` StaticAssetPricing, required
      - `requestsFreeAndUnlimited` boolean, required
      - `storageFree` boolean, required
    - `subscriptionUsdCentsPerMonth` integer, required
    - `workers` WorkerPricing, required
      - `cpuOverageUsdMicrosPerMillionMs` integer, nullable, required
      - `includedCpuMsPerMonth` integer, nullable, required
      - `includedRequestsPerMonth` integer, nullable, required
      - `requestOverageUsdMicrosPerMillion` integer, nullable, required
  - `profile` AccountProfileResponse, required
    - `accountId` string, required
    - `accountUrl` string, uri, nullable, required
    - `displayName` string, nullable, required
    - `email` string, email, required
    - `handle` string, nullable, required
    - `plan` 'free' | 'pro', required
    - `provider` 'github' | 'google', required
  - `usage` AccountOverviewUsage, required
    - `cronTriggerCount` integer, required
    - `customDomainCount` integer, required
    - `databaseCount` integer, required
    - `databaseStorageMib` integer, required
    - `deployCount` integer, required
    - `kvNamespaceCount` integer, required
    - `meters` AccountUsageMeters, required
      - `day` AccountUsageMeterWindow, required
        - `build_minutes` integer
        - `kv_deletes` integer
        - `kv_lists` integer
        - `kv_reads` integer
        - `kv_storage_bytes` integer
        - `kv_writes` integer
        - `log_events` integer
        - `object_storage_bytes` integer
        - `object_storage_class_a_operations` integer
        - `object_storage_class_b_operations` integer
        - `object_storage_egress_bytes` integer
        - `queue_operations` integer
        - `sqlite_rows_read` integer
        - `sqlite_rows_written` integer
        - `sqlite_storage_bytes` integer
        - `state_duration_gb_milliseconds` integer
        - `state_requests` integer
        - `state_sqlite_rows_read` integer
        - `state_sqlite_rows_written` integer
        - `state_sqlite_storage_bytes` integer
        - `static_transfer_bytes` integer
        - `worker_cpu_ms` integer
        - `worker_requests` integer
        - `worker_transfer_bytes` integer
      - `month` AccountUsageMeterWindow, required
        - `build_minutes` integer
        - `kv_deletes` integer
        - `kv_lists` integer
        - `kv_reads` integer
        - `kv_storage_bytes` integer
        - `kv_writes` integer
        - `log_events` integer
        - `object_storage_bytes` integer
        - `object_storage_class_a_operations` integer
        - `object_storage_class_b_operations` integer
        - `object_storage_egress_bytes` integer
        - `queue_operations` integer
        - `sqlite_rows_read` integer
        - `sqlite_rows_written` integer
        - `sqlite_storage_bytes` integer
        - `state_duration_gb_milliseconds` integer
        - `state_requests` integer
        - `state_sqlite_rows_read` integer
        - `state_sqlite_rows_written` integer
        - `state_sqlite_storage_bytes` integer
        - `static_transfer_bytes` integer
        - `worker_cpu_ms` integer
        - `worker_requests` integer
        - `worker_transfer_bytes` integer
    - `monthlyBuildMinutes` integer, required
    - `monthlyDeployCount` integer, required
    - `objectStorageMib` integer, required
    - `queueCount` integer, required
    - `runningCount` integer, required
    - `runtimeCpuMillis` integer, required
    - `runtimeMemoryMib` integer, required
    - `serviceCount` integer, required
    - `stateNamespaceCount` integer, required
    - `storageObjectCount` integer, required
    - `usageCapCount` integer, required

## Other responses

- `400`
- `401`
- `429`
- `500`

## Changes

- **2026-06-01** `80ee119de8db` — 5 info
  - added the optional property `usage/meters/day/object_storage_egress_bytes` to the response with the `200` status
  - added the optional property `usage/meters/month/object_storage_egress_bytes` to the response with the `200` status
  - added the required property `limits/objectStorageEgressBytesPerMonth` to the response with the `200` status
  - added the required property `pricing/objectStorage/egressOverageUsdMicrosPerTb` to the response with the `200` status
  - …1 more
- **2026-06-01** `3597d11cb5fa` — 1 info
  - added the required property `limits/serviceBindingInvocationsPerRequest` to the response with the `200` status
- **2026-06-01** `d4160125c4ac` — 1 info
  - added the required property `limits/stateAlarmDurationSeconds` to the response with the `200` status

[Change history](https://skmtc.dev/tovuk/apis/tovuk-api/changes/v1/usage/get.md)

---

[API](https://skmtc.dev/tovuk/apis/tovuk-api.md) · [All operations](https://skmtc.dev/tovuk/apis/tovuk-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tovuk/tovuk-api/revisions/830163d2c8bf/schema)