---
title: "POST /v1/projects/{project_id}/audits/estimate"
method: POST
path: "/v1/projects/{project_id}/audits/estimate"
tags: ["audits"]
---

# POST /v1/projects/{project_id}/audits/estimate

`POST /v1/projects/{project_id}/audits/estimate`

## Request

- Base URL: `https://api.citeladder.com`
- URL: `https://api.citeladder.com/v1/projects/{project_id}/audits/estimate`
- Auth: HTTP bearer

## Path parameters

- `project_id` string, uuid, required

## Request body

- object
  - `prompt_set_id` string, uuid, nullable
  - `prompt_ids` string[]
  - `engines` LogicalEngine[], required
  - `repetitions` integer, nullable
  - `market_ids` string[]

## Response `200`

Successful Response

- AuditEstimate
  - `retrieval_enabled` boolean, required
  - `prompt_count` integer, required
  - `engine_count` integer, required
  - `repetition_count` integer, required
  - `market_count` integer, required
  - `execution_count` integer, required
  - `maximum_attempt_count` integer, required
  - `maximum_wall_clock_seconds` integer, required
  - `cost_status` 'complete' | 'partial' | 'unknown', required
  - `estimated_total_cost_microusd` integer, nullable, required
  - `engines` object[], required
    - `logical_engine` 'chatgpt' | 'gemini' | 'claude' | 'google_ai_overview' | 'chatgpt_search' | 'gemini_consumer', required
    - `transport_provider` 'openai' | 'anthropic' | 'google' | 'dataforseo', required
    - `transport_model` string, required
    - `retrieval_enabled` boolean, nullable, required
    - `prompt_count` integer, required
    - `repetition_count` integer, required
    - `market_count` integer, required
    - `execution_count` integer, required
    - `maximum_attempt_count` integer, required
    - `estimated_input_tokens` integer, nullable, required
    - `estimated_output_tokens` integer, nullable, required
    - `estimated_search_calls` integer, nullable, required
    - `estimated_token_cost_microusd` integer, nullable, required
    - `estimated_search_cost_microusd` integer, nullable, required
    - `estimated_total_cost_microusd` integer, nullable, required
    - `cost_status` 'complete' | 'partial' | 'unknown', required
    - `pricing_version` string, required

---

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