GET
/
api
/
calls
/
{call_id}
/
stages
/
{call_stage_id}
curl --request GET \
  --url https://api.ultravox.ai/api/calls/{call_id}/stages/{call_stage_id} \
  --header 'X-API-Key: <api-key>'
{
  "callId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "callStageId": "3c90c3cc-0d44-4b50-8888-8dd25736052a",
  "created": "2023-11-07T05:31:56Z",
  "inactivityMessages": [
    {
      "duration": "<string>",
      "message": "<string>",
      "endBehavior": "END_BEHAVIOR_UNSPECIFIED"
    }
  ],
  "languageHint": "<string>",
  "model": "fixie-ai/ultravox",
  "systemPrompt": "<string>",
  "temperature": 123,
  "timeExceededMessage": "<string>",
  "voice": "<string>",
  "externalVoice": {
    "elevenLabs": {
      "voiceId": "<string>",
      "model": "<string>",
      "speed": 123,
      "useSpeakerBoost": true,
      "style": 123,
      "similarityBoost": 123,
      "stability": 123,
      "pronunciationDictionaries": [
        {
          "dictionaryId": "<string>",
          "versionId": "<string>"
        }
      ],
      "optimizeStreamingLatency": 123
    },
    "cartesia": {
      "voiceId": "<string>",
      "model": "<string>",
      "speed": 123,
      "emotion": "<string>",
      "emotions": [
        "<string>"
      ]
    },
    "playHt": {
      "userId": "<string>",
      "voiceId": "<string>",
      "model": "<string>",
      "speed": 123,
      "quality": "<string>",
      "temperature": 123,
      "emotion": 123,
      "voiceGuidance": 123,
      "styleGuidance": 123,
      "textGuidance": 123,
      "voiceConditioningSeconds": 123
    },
    "lmnt": {
      "voiceId": "<string>",
      "model": "<string>",
      "speed": 123,
      "conversational": true
    }
  },
  "errorCount": 123,
  "experimentalSettings": "<any>",
  "initialState": {}
}

Authorizations

​
X-API-Key
string
header
required

API key

Path Parameters

​
call_id
string
required
​
call_stage_id
string
required

Response

200 - application/json
​
callId
string
required
​
callStageId
string
required
​
created
string
required
​
temperature
number
required
​
errorCount
integer
required

The number of errors in this call stage.

​
experimentalSettings
any | null
required

Experimental settings for this call stage.

​
initialState
object
required

The initial state of the call stage which is readable/writable by tools.

​
inactivityMessages
object[]

Messages spoken by the agent when the user is inactive for the specified duration. Durations are cumulative, so a message m > 1 with duration 30s will be spoken 30 seconds after message m-1.

A message the agent should say after some duration. The duration's meaning varies depending on the context.

​
languageHint
string | null

BCP47 language code that may be used to guide speech recognition.

Maximum length: 16
​
model
string
default:fixie-ai/ultravox
​
systemPrompt
string | null
​
timeExceededMessage
string | null
​
voice
string | null
​
externalVoice
object

A voice not known to Ultravox Realtime that can nonetheless be used for a call. Such voices are significantly less validated than normal voices and you'll be responsible for your own TTS-related errors. Exactly one field must be set.