Skip to main content
GET
/
api
/
v1
/
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"

{
  "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

​
agent_id
string
required
Agent UUID.

​
Request headers

​
Authorization
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"

​
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

​
data.eligible
boolean
required
Whether the agent currently meets the volume threshold for optimized costs.
​
data.current_calls
integer
required
Number of calls placed by this agent in the last threshold_days days.
​
data.required_calls
integer
required
Volume threshold required for eligibility.
​
data.threshold_days
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.