---
title: "Get devbox resource usage by day."
method: GET
path: "/v1/usage/devboxes"
tags: ["Devbox"]
---

# Get devbox resource usage by day.

`GET /v1/usage/devboxes`

Returns a paginated list of daily resource usage records.

## Query parameters

- `limit` integer
- `starting_after` string

## Response `200`

OK

- DevboxUsageListView
  - `daily_usage` DevboxUsageView[], required — The list of daily usage records in order of start time.
    - `start_time_ms` integer, required — The start time of the usage period in milliseconds since epoch.
    - `end_time_ms` integer, required — The end time of the usage period in milliseconds since epoch.
    - `resource_hourly_usages` object, required — A map of hourly resource usage, keyed by hour (0-23).
    - `resource_daily_usages` ResourceAggregateUsage, required
      - `resource_usages` ResourceUsage[], required — A list of resource usages for the hour, each with a resource type and usage amount.
        - `resource` string, required — The type of resource (e.g., 'cpu', 'memory').
        - `usage` integer, required — Usage amount for the resource during the hour, in appropriate units.
      - `devbox_creates` object, required — A map of resource creation counts, keyed by resource type.
  - `has_more` boolean
  - `total_count` integer
  - `remaining_count` integer

---

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