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

# Cloudzero Dry Run Export

`POST /cloudzero/dry-run`

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.net/sea-lion/apis/litellm-api.md) · [All operations](https://skmtc.net/sea-lion/apis/litellm-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/sea-lion/litellm-api/revisions/1e929292ddd5/schema)