curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
  -H "Authorization: Bearer talq_your_environment_token_here"

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();

{
  "success": true,
  "data": {
    "eligible": true,
    "current_calls": 842,
    "required_calls": 700,
    "threshold_days": 7
  }
}

GET

api

agents

{agent_id}

optimized-costs-eligibility

curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
  -H "Authorization: Bearer talq_your_environment_token_here"

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();

{
  "success": true,
  "data": {
    "eligible": true,
    "current_calls": 842,
    "required_calls": 700,
    "threshold_days": 7
  }
}

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

string

required

Agent UUID.

Request headers

string

required

Bearer token for authentication. Format: Bearer talq_your_environment_token_here

Examples

curl "https://app.talkover.ai/api/v1/agents/550e8400-e29b-41d4-a716-446655440000/optimized-costs-eligibility" \
  -H "Authorization: Bearer talq_your_environment_token_here"

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();

Response

Eligible

{
  "success": true,
  "data": {
    "eligible": true,
    "current_calls": 842,
    "required_calls": 700,
    "threshold_days": 7
  }
}

Not Eligible

{
  "success": true,
  "data": {
    "eligible": false,
    "current_calls": 312,
    "required_calls": 700,
    "threshold_days": 7,
    "calls_remaining": 388
  }
}

Response fields

boolean

required

Whether the agent currently meets the volume threshold for optimized costs.

integer

required

Number of calls placed by this agent in the last threshold_days days.

integer

required

Volume threshold required for eligibility.

integer

required

Window size in days used to count calls.

Notes

Once eligible, enable optimized costs via 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.

Get Started

Concepts

API Reference

Guides

Check Optimized Costs Eligibility

Check Optimized Costs Eligibility

Endpoint

Path parameters

Request headers

Examples

Response

Eligible

Not Eligible

Response fields

Notes

​Check Optimized Costs Eligibility

​Endpoint

​Path parameters

​Request headers

​Examples

​Response

​Eligible

​Not Eligible

​Response fields

​Notes

Check Optimized Costs Eligibility

Endpoint

Path parameters

Request headers

Examples

Response

Eligible

Not Eligible

Response fields

Notes