---
title: "Cloudzero Dry Run Export"
method: POST
path: "/cloudzero/dry-run"
tags: ["CloudZero"]
---

# Cloudzero Dry Run Export

`POST /cloudzero/dry-run`

## Request

- Base URL: `https://api.vibebrowser.app` (the document declares no server; this is the origin it was published from)
- URL: `https://api.vibebrowser.app/cloudzero/dry-run`
- Auth: one of:
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`
  - API key in header `x-litellm-api-key`

Perform a dry run export using the CloudZero logger.

This endpoint uses the CloudZero logger to perform a dry run export,
which returns the data that would be exported without actually sending it to CloudZero.

Parameters:
- limit: Optional limit on number of records to process (default: 10000)

Returns:
- usage_data: Sample of the raw usage data (first 50 records)
- cbf_data: CloudZero CBF formatted data ready for export
- summary: Statistics including total cost, tokens, and record counts

Only admin users can perform CloudZero exports.

## Request body

- CloudZeroExportRequest: Request model for CloudZero export operations
  - `limit` integer, nullable: Optional limit on number of records to export
  - `operation` string: CloudZero operation type (replace_hourly or sum)
  - `start_time_utc` string, date-time, nullable: Start time for data export in UTC
  - `end_time_utc` string, date-time, nullable: End time for data export in UTC

## Response `200`

Successful Response

- CloudZeroExportResponse: Response model for CloudZero export operations
  - `message` string, required
  - `status` string, required
  - `records_exported` integer, nullable
  - `dry_run_data` object, nullable: Dry run data including usage data and CBF transformed data
  - `summary` object, nullable: Summary statistics for dry run

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/vibebrowser/apis/litellm-api.md) · [All operations](https://skmtc.dev/vibebrowser/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc.dev/vibebrowser/apis/litellm-api/revisions/eea0b7e7b167?raw)