---
title: "Preview Batch Cost"
method: POST
path: "/v1/batch/preview-cost"
tags: ["Cost Control"]
---

# Preview Batch Cost

`POST /v1/batch/preview-cost`

Estimate the credit cost and budget impact of a batch enrichment without reserving or consuming credits. FREE dry-run.

## Request body

- PreviewCostRequest
  - `items` object[], required
    - `product` string — Required for mixed-product mode. Omitted for per-product mode.
    - `input` object
    - `client_id` string
    - `client_name` string
    - `metadata` object
  - `budget_user_id` string — User ID to check against configured Credit Budgets.
  - `client_id` string
  - `client_name` string
  - `metadata` object

## Response `200`

Cost estimate returned (no credits consumed).

- PreviewCostResponse
  - `totalItems` integer, required
  - `creditsPerItem` number, nullable
  - `totalCredits` number, required
  - `estimatedCostUsd` number, required
  - `perProduct` object[], required
    - `product` string
    - `items` integer
    - `creditsPerItem` number
    - `credits` number
  - `clientCreditRemaining` string, nullable
  - `willExceedBudget` boolean, required

## Other responses

- `400` — Bad Request - The request was malformed or contains invalid parameters. **Common causes:** - Missing required fields - Invalid field format (e.g., malformed email) - Invalid JSON syntax - Invalid parameter values
- `401` — Unauthorized - Authentication failed. **Common causes:** - Missing X-API-Key header - Invalid or expired API key - Malformed API key
- `429` — Too Many Requests - Rate limit exceeded. **Action required:** Check the `Retry-After` header for when to retry. **Headers returned:** - `Retry-After`: Seconds until you can retry - `RateLimit-Limit`: Your limit per minute - `RateLimit-Remaining`: Remaining requests this minute - `RateLimit-Reset`: Seconds until limit resets
- `500` — Internal Server Error - Something went wrong on our end. **Action required:** Wait 30 seconds and retry. If the problem persists, contact support@leadmagic.io

---

[API](https://skmtc.net/leadmagic/apis/leadmagic-api.md) · [All operations](https://skmtc.net/leadmagic/apis/leadmagic-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/leadmagic/leadmagic-api/revisions/aa19cf9bc46a/schema)