---
title: "Export settled usage for every visible product and resource over a UTC date range."
method: GET
path: "/v1/usage/export"
tags: ["account"]
---

# Export settled usage for every visible product and resource over a UTC date range.

`GET /v1/usage/export`

## Request

- Base URL: `https://api.withruntime.com`
- URL: `https://api.withruntime.com/v1/usage/export`
- Auth: HTTP bearer

Selects settlement timestamps in [since, until), with exact decimal strings for money and quantities. Pending holds are excluded. Each page contains data, nextCursor and server-rendered CSV; concatenate CSV pages in order, with the header on the first page only. Follow nextCursor with the same range. Pages use deterministic timestamp/id ordering and preserve microseconds; they are live reads, not a retained database snapshot. Every page rechecks the key's usage permission and tenant visibility. finalThrough is a moment before which no row can still appear or change; a row's final is true once its resource is deleted and every charge it will have is settled before finalThrough.

## Query parameters

- `since` string: Inclusive UTC ISO timestamp with Z, for example 2026-09-01T00:00:00.000Z.
- `until` string: Exclusive UTC ISO timestamp with Z.
- `cursor` string
- `limit` integer

## Response `200`

Success

- object
  - `since` string, required
  - `until` string, required
  - `nextCursor` string, nullable, required
  - `finalThrough` string, nullable, required
  - `csv` string, required
  - `data` object[], required
    - `intervalId` string, required: Resource identifier (UUID).
    - `resourceId` string, required: Resource identifier (UUID).
    - `name` string, nullable, required
    - `kind` string, required
    - `meter` string, required
    - `fundedBy` 'credit' | 'trial' | 'allowance', required
    - `startsAt` string, required
    - `endsAt` string, required
    - `settledAt` string, required
    - `billedMilliseconds` string, nullable, required
    - `chargedMicros` string, required: Exact integer count, as a decimal string.
    - `quotedRates` object[], required
      - `component` string, required
      - `unit` string, required
      - `rateMicros` string, required: Exact integer count, as a decimal string.
    - `measurementsJson` string, nullable, required
    - `evidence` 'measured' | 'partial' | 'missing' | 'null', nullable, required
    - `final` boolean, required

## Other responses

- `default`: Error

---

[API](https://skmtc.dev/withruntime/apis/runtime-cloud-api.md) · [All operations](https://skmtc.dev/withruntime/apis/runtime-cloud-api/llms.txt) · [OpenAPI document](https://skmtc.dev/withruntime/apis/runtime-cloud-api/revisions/6f4012286988?raw)