---
title: "List hourly sandbox usage costs"
method: GET
path: "/api/v2/sandboxes/usage/costs"
tags: ["sandboxes"]
---

# List hourly sandbox usage costs

`GET /api/v2/sandboxes/usage/costs`

## Request

- Base URL: `https://api.smith.langchain.com`
- URL: `https://api.smith.langchain.com/api/v2/sandboxes/usage/costs`
- Auth: one of:
  - API key in header `X-API-Key` and API key in header `X-Tenant-Id`
  - HTTP bearer and API key in header `X-Tenant-Id`

Returns priced usage per sandbox or snapshot and UTC hour in the half-open requested interval. LCU uses the recorded compute amount for sandboxes; snapshots have zero LCU. LSU allocates the recorded workspace storage amount proportionally to attributed bytes, including checkpoints on their sandbox and snapshots as separate resources. Resource filters preserve each resource's share. Rate changes do not reprice recorded amounts. An access-filtered page can have no items and a non-null next_cursor; continue until next_cursor is null.

## Query parameters

- `start_time` string, date-time, required
- `end_time` string, date-time, required
- `resource_type` 'SANDBOX' | 'SNAPSHOT'
- `resource_ids` string[]
- `page_size` integer
- `granularity` 'HOUR' | 'RESOURCE'
- `cursor` string
- `include_totals` boolean

## Response `200`

OK

- SandboxesSandboxUsageCostsResponse
  - `items` SandboxesSandboxUsageCost[], required
    - `compute_standard_units` string, decimal, nullable: Recorded compute usage in Standard Units, as a decimal string, separate from LCU. Null means complete Standard compute usage is unavailable; "0" means known zero usage.
    - `lcu` string, decimal, required: Recorded compute usage in LangSmith Compute Units (LCU), as a decimal string with up to six fractional digits and trailing zeros omitted. Snapshots return "0".
    - `lsu` string, decimal, required: Allocated storage usage in LangSmith Storage Units (LSU), as a decimal string with up to six fractional digits and trailing zeros omitted.
    - `period_start` string, date-time, required
    - `resource_id` string, uuid, required
    - `resource_type` 'SANDBOX' | 'SNAPSHOT', required
    - `storage_standard_units` string, decimal, nullable: Allocated storage usage in Standard Units, as a decimal string, separate from LSU. Null means complete Standard storage usage is unavailable; "0" means known zero usage.
  - `next_cursor` string, nullable, required
  - `totals` SandboxesSandboxUsageCostTotals
    - `compute_standard_units` string, decimal, nullable: Total compute usage in Standard Units across the entire filtered interval, independent of pagination, as a decimal string, separate from LCU. Null means complete Standard compute usage is unavailable; "0" means known zero usage.
    - `lcu` string, decimal, required
    - `lsu` string, decimal, required
    - `storage_standard_units` string, decimal, nullable: Total storage usage in Standard Units across the entire filtered interval, independent of pagination, as a decimal string, separate from LSU. Null means complete Standard storage usage is unavailable; "0" means known zero usage.

## Other responses

- `400`: missing or invalid query parameters
- `401`: missing or invalid authentication
- `403`: forbidden (insufficient permission)
- `500`: internal server error

## Changes

- **2026-10-20** `60663ca33d8a`: 4 info
  - added the optional property `items/items/compute_standard_units` to the response with the `200` status
  - added the optional property `items/items/storage_standard_units` to the response with the `200` status
  - added the optional property `totals/allOf[#/components/schemas/sandboxes.SandboxUsageCostTotals]/compute_standard_units` to the response with the `200` status
  - added the optional property `totals/allOf[#/components/schemas/sandboxes.SandboxUsageCostTotals]/storage_standard_units` to the response with the `200` status
- **2026-10-16** `1a8ee9358d81`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/langchain-ai/apis/langsmith/changes/api/v2/sandboxes/usage/costs/get.md)

---

[API](https://skmtc.dev/langchain-ai/apis/langsmith.md) - [All operations](https://skmtc.dev/langchain-ai/apis/langsmith/llms.txt) - [OpenAPI document](https://skmtc.dev/langchain-ai/apis/langsmith/revisions/7a01c01f75e8?raw)