See how fast an agent answers

GET
/v1/agents/{id}/latency

Averages what the agent's recent calls measured, over the last 30 days: how long the caller waited from the end of their words to the first sound of the answer (endToEnd), and the parts of it: listening (noticing the caller stopped, and transcribing), thinking (the language model) and speaking (the voice's first audio). Whole milliseconds. avgMs is null until a call has been measured. When realtime is true most turns were answered by a speech-to-speech model, which folds listening and speaking into the model.

Requires an API key with the workspace:read scope.

Authorization

apiKey
headerAuthorizationBearer <token>

A secret API key from the dashboard (Developers → API keys): vl_live_…, or vl_test_… for test mode. Each operation says which scope the key needs.

Path Parameters

id*string

The agent id.

Response Body

The agent's measured average answer times over the last 30 days

application/json
  1. response
windowDays*30
Value in30
calls*integer

Calls in the window that have at least one measured turn

Range0 <= value
turns*integer

Answered turns measured across those calls

Range0 <= value
avgMs*|

null while there are no measured turns

realtime*boolean

Most turns were answered by a speech-to-speech model, which folds listening and speaking into the model

Example Request
curl "https://api.vlayers.ai/v1/agents/$AGENT_ID/latency" \  -H "Authorization: Bearer $VOICELAYER_API_KEY"
Example Response
{  "windowDays": 30,  "calls": 42,  "turns": 311,  "avgMs": {    "endToEnd": 1320,    "listening": 410,    "thinking": 640,    "speaking": 270  },  "realtime": false}