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

# Check Optimized Costs Eligibility

> Check whether an agent qualifies for optimized cost pricing

# Check Optimized Costs Eligibility

Check whether an agent qualifies for optimized cost pricing. Optimized costs apply caching to repeated agent prompts and reduce per-call cost — eligibility is based on call volume over a recent window.

## Endpoint

```
GET /api/v1/agents/{agent_id}/optimized-costs-eligibility
```

## Path parameters

<ParamField path="agent_id" type="string" required>
  Agent UUID.
</ParamField>

## Request headers

<ParamField header="Authorization" type="string" required>
  Bearer token for authentication. Format: `Bearer talq_your_environment_token_here`
</ParamField>

## Examples

<RequestExample>
  ```bash theme={null}
  curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
    -H "Authorization: Bearer talq_your_environment_token_here"
  ```

  ```javascript theme={null}
  const response = await fetch('https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility', {
    headers: { 'Authorization': 'Bearer talq_your_environment_token_here' }
  });

  const result = await response.json();
  ```
</RequestExample>

## Response

### Eligible

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "eligible": true,
      "current_calls": 842,
      "required_calls": 700,
      "threshold_days": 7
    }
  }
  ```
</ResponseExample>

### Not Eligible

<ResponseExample>
  ```json theme={null}
  {
    "success": true,
    "data": {
      "eligible": false,
      "current_calls": 312,
      "required_calls": 700,
      "threshold_days": 7,
      "calls_remaining": 388
    }
  }
  ```
</ResponseExample>

### Response fields

<ResponseField name="data.eligible" type="boolean" required>
  Whether the agent currently meets the volume threshold for optimized costs.
</ResponseField>

<ResponseField name="data.current_calls" type="integer" required>
  Number of calls placed by this agent in the last `threshold_days` days.
</ResponseField>

<ResponseField name="data.required_calls" type="integer" required>
  Volume threshold required for eligibility.
</ResponseField>

<ResponseField name="data.threshold_days" type="integer" required>
  Window size in days used to count calls.
</ResponseField>

## Notes

* Once eligible, enable optimized costs via [Update Advanced Settings](/api-reference/endpoints/update-advanced-settings) by setting `enable_initial_message_cache: true`.
* Eligibility is checked in real time — keep polling this endpoint or check periodically.
* Agents that drop below the threshold may be reverted to standard pricing automatically.