---
title: "Usage"
method: GET
path: "/cloud-computers/{computer_id}/usage"
tags: ["cloud-computers"]
---

# Usage

`GET /cloud-computers/{computer_id}/usage`

## Request

- Base URL: `https://api.moda.app/v1`
- URL: `https://api.moda.app/v1/cloud-computers/{computer_id}/usage`
- Auth: HTTP bearer

## Path parameters

- `computer_id` string, required

## Headers

- `Moda-Version` '2026-04-12' | '2026-05-01'

## Response `200`

Successful Response

- CloudUsageView
  - `period_start` string, date-time, required
  - `period_end` string, date-time, required
  - `compute_credits` number, required
  - `ai_and_gpu_credits` number, required
  - `storage_credits` number, required
  - `total_credits` number, required
  - `spending_limit_credits` integer, nullable, required
  - `remaining_limit_credits` number, nullable, required
  - `allotment_credits` number, required
  - `allotment_used_credits` number, required
  - `alerts` CloudUsageAlertView[], required
    - `threshold` 50 | 75 | 90, required
    - `reached_at` string, date-time, required
  - `storage_bytes` integer, required
  - `awake_seconds` integer, required
  - `billed_blocks` integer, required

## Other responses

- `401`: Authentication required.
- `402`: Insufficient credits for a metered operation.
- `403`: Permission denied for this scope.
- `404`: Resource not found.
- `409`: Conflict (idempotency / resource state).
- `422`: Request validation failed.
- `429`: Rate limit exceeded.
- `500`: Internal error.

## Changes

- **2026-11-03** `9ac6a3abc0f8`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/moda/apis/moda-public-api/changes/cloud-computers/:computer_id/usage/get.md)

---

[API](https://skmtc.dev/moda/apis/moda-public-api.md) - [All operations](https://skmtc.dev/moda/apis/moda-public-api/llms.txt) - [OpenAPI document](https://skmtc.dev/moda/apis/moda-public-api/revisions/9ac6a3abc0f8?raw)