API

API documentation

What a telecom engineer should get in 5 minutes: authentication, examples and response formats.

https://api.lionvoice.app/v1

Authentication

Every request carries an API key. The key is created in the client portal and can be restricted by IP addresses.

curl -s https://api.lionvoice.app/v1/calls \
  -H "Authorization: Bearer sk_live_..." \
  -H "Content-Type: application/json"
  • Bearer key in the header
  • IP allowlist
  • Separate test and production keys

Calls

Create an outbound call or get a call record with transcription.

POST /v1/calls
{
  "agent_id": "agt_123",
  "to": "+37060000000",
  "from": "+37061234567",
  "language": "lt"
}
  • call.completed webhook
  • transcription and summary
  • duration in seconds for billing

Agents

AI assistant configuration: instruction, voice, language, tools and knowledge base.

POST /v1/agents
{
  "name": "Tele2 customer line",
  "voice": "Alistair",
  "language": "lt",
  "prompt": "You are..."
}
  • voice and model
  • tool connection
  • knowledge base link

Knowledge

Upload a website or documents — the system splits them into chunks and uses them in answers.

POST /v1/knowledge
{
  "source": "https://tele2.lt",
  "refresh": "daily"
}
  • URL sources
  • file upload
  • automatic refresh

Email AI

Connect your IMAP and SMTP. The system reads incoming emails and replies through your mailbox.

POST /v1/email/accounts
{
  "imap": "imap.example.lt:993",
  "smtp": "smtp.example.lt:587",
  "mode": "draft"
}
  • IMAP / SMTP
  • draft or automatic sending
  • action log

Webhooks

The system notifies your systems about events with an HMAC signature.

POST https://tavo-sistema.lt/hook
{
  "event": "call.completed",
  "call_id": "cal_9f2",
  "duration": 84
}
  • call.completed
  • email.received
  • handoff.requested

Usage and invoices

Minutes are measured to the second. The monthly invoice is generated automatically.

GET /v1/usage/minutes?from=2026-09-01
{
  "minutes": 18420,
  "amount_eur": 1105.20
}
  • second-level accuracy
  • monthly report
  • CSV / PDF export

Want to see your scenario?

I'll show you how AI answers calls for your business customers — in Lithuanian, Latvian and 22 more languages.

Let's book a live demo