Skip to main content
GET
/
api
/
v1
/
sip-trunks
/
{trunk_id}
/
health
curl "https://app.talkover.ai/api/v1/sip-trunks/trunk-uuid-1/health" \
  -H "Authorization: Bearer talq_your_environment_token_here"

{
  "success": true,
  "data": {
    "is_healthy": true,
    "response_time_ms": 142,
    "checked_at": "2024-01-15T14:35:00Z"
  }
}

​
Get SIP Trunk Health

Run a live health check on a SIP trunk and return the current status. Lightweight version of Verify SIP Trunk — does not change the trunk’s is_verified flag.

​
Endpoint

GET /api/v1/sip-trunks/{trunk_id}/health

​
Path parameters

​
trunk_id
string
required
SIP trunk UUID.

​
Request headers

​
Authorization
string
required
Bearer token. Format: Bearer talq_your_environment_token_here

​
Examples

curl "https://app.talkover.ai/api/v1/sip-trunks/trunk-uuid-1/health" \
  -H "Authorization: Bearer talq_your_environment_token_here"

​
Response

{
  "success": true,
  "data": {
    "is_healthy": true,
    "response_time_ms": 142,
    "checked_at": "2024-01-15T14:35:00Z"
  }
}

​
Unhealthy Response

{
  "success": true,
  "data": {
    "is_healthy": false,
    "response_time_ms": 5000,
    "error": "Connection timeout",
    "checked_at": "2024-01-15T14:35:00Z"
  }
}

​
Notes

  • Use this endpoint for monitoring/alerting integrations.
  • Frequent polling is fine — checks are cached for short windows.