🚀 lisn.dev is in beta — Try it out →

Build intelligent voice and text analysis pipelines with the lisn.dev API

Quickstart

Get up and running in three steps.

Step 1: Get Your API Token

All API requests require a Bearer token. Generate one from the Settings → API Tokens page in your dashboard.

Authorization: Bearer YOUR_API_TOKEN

👉 Read the Authentication guide →

Step 2: Create an Assistant

An Assistant is the core resource. Each has a type (voice or text), an LLM configuration, and optionally an STT provider.

curl -X POST "https://app.lisn.dev/api/v1/assistants" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Sales Analyzer",
    "type": "voice",
    "stt_provider": "elevenlabs",
    "stt_language": "Auto-Detect",
    "llm_provider": "openai",
    "llm_model": "gpt-4o-mini",
    "system_prompt": "Analyze this call transcript...",
    "temperature": 0.7
  }'

👉 Learn more about Assistants →

Step 3: Send Data for Analysis

Voice — upload an audio file:

curl -X POST "https://app.lisn.dev/api/v1/requests/voice" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -F "assistant_id=ast_abc123" \
  -F "audio_file=@recording.wav"

Text — send a conversation:

curl -X POST "https://app.lisn.dev/api/v1/requests/text" \
  -H "Authorization: Bearer YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "assistant_id": "ast_xyz789",
    "conversation": [
      {"role": "operator", "text": "How can I help?"},
      {"role": "client", "text": "I need pricing info"}
    ]
  }'

👉 Voice Analysis → · Text Analysis →

What's Next?

SectionDescription
Response FormatUnderstand the session object returned after processing
WebhooksReceive results via webhook callbacks
ErrorsHTTP status codes and error handling
SDK & ExamplesPython, JavaScript, and cURL examples

Base URL

https://app.lisn.dev/api

Need Help?