List voice assistants

GET https://app.sendapp.ai/api/voice/assistants

Returns the assistants of your account that have Voice AI set up, with language and phone number. assistant_id is the value to use in the other Voice AI endpoints.

You need a plan with Voice AI and API access, and the Voice AI app switched on in the Apps page. With an expired plan you can still read; changes are refused.

Common errors: 401 API key missing or wrong — 403 plan without API access or without Voice AI, Voice AI app switched off, account suspended — 404 call or assistant that does not exist or is not yours — 422 invalid parameters — 429 too many requests: try again after the seconds given in Retry-After.

Parameters

1 · 1 required

apikey required

Your API Key (the X-API-Key header also works).

Need help with the integration? info@sendapp.live

Request

curl 'https://app.sendapp.ai/api/voice/assistants' \
  -H 'X-API-Key: YOUR_API_KEY'

<?php
$ch = curl_init('https://app.sendapp.ai/api/voice/assistants');
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ['X-API-Key: YOUR_API_KEY'],
]);
$res = json_decode(curl_exec($ch), true);
curl_close($ch);

const res = await fetch('https://app.sendapp.ai/api/voice/assistants', {
  headers: { 'X-API-Key': 'YOUR_API_KEY' }
});
console.log(await res.json());

Response

{
  "status": "success",
  "assistants": [
    {
      "assistant_id": "YOUR_ACCOUNT_TOKEN",
      "name": "Studio Dentistico Rossi",
      "language": "it",
      "number": "+390212345678"
    }
  ]
}

{
  "status": "error",
  "message": "Your current plan does not include Voice AI."
}