> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bland.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Estimate Eval Run

> Preview the size and cost of a run before starting it.

### Headers

**authorization** `string` *required*

Your API key for authentication.

### Body Parameters

Accepts the same body as [Create Eval Run](https://docs.bland.ai/api-v1/post/evals-runs.md). Key fields:

**call\_ids** `array of string` *required*

The call IDs to include in the estimate. Between 1 and 5000 calls.

**attached\_agents** `array of objects`

The eval agents to score with. Required when `workbench_setup_version_id` is not provided.

**workbench\_setup\_version\_id** `string`

Pinned workbench setup version whose agent roster supplies the agents. Required when `attached_agents` is not provided. Must be provided together with `workbench_setup_id`.

### Response

**resolved\_atom\_count** `integer`

Number of call-by-agent evaluations the run will perform.

**estimated\_input\_tokens** `integer`

Estimated number of input tokens consumed by judge calls.

**estimated\_output\_tokens** `integer`

Estimated number of output tokens produced by judge calls.

**estimated\_cost\_usd\_cents** `number`

Estimated billable cost in USD cents.

```json Response theme={null}
{
  "data": {
    "resolved_atom_count": 150,
    "estimated_input_tokens": 420000,
    "estimated_output_tokens": 15000,
    "estimated_cost_usd_cents": 87.5
  },
  "errors": null
}
```


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.