Skip to main content
GET
/
v1
/
voice
/
calls
List Call History
curl --request GET \
  --url https://api.example.com/v1/voice/calls \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "calls": [
    {
      "call_id": "<string>",
      "voice_agent_id": "<string>",
      "agent_id": "<string>",
      "agent_name": "<string>",
      "organization_id": "<string>",
      "user_id": "<string>",
      "tenant_id": "<string>",
      "start_timestamp": 123,
      "end_timestamp": 123,
      "call_status": "<string>",
      "direction": "<string>",
      "user_sentiment": "<string>",
      "call_successful": true,
      "in_voicemail": true,
      "from_number": "<string>",
      "to_number": "<string>",
      "recording_url": "<string>",
      "recording_s3_key": "<string>",
      "recording_downloaded_at": {},
      "call_started_at": {},
      "call_ended_at": {},
      "call_analyzed_at": {},
      "created_at": {},
      "updated_at": {}
    }
  ],
  "count": 123,
  "powered_by": "<string>"
}

​
Description

Lists all calls from your organization’s call history (stored in Teli Voice database). Returns call metadata including duration, sentiment, and recording URLs. Data Source: Teli Voice call history database (NOT live provider data)

​
Authentication

​
X-API-Key
string
required
Your Teli API key

​
Query Parameters

​
organization_id
string
required
Organization unique_id to filter calls
​
user_id
string
User unique_id (required for non-admin users to filter their calls)
​
is_admin
boolean
default:"false"
If true, returns all organization calls. If false, returns only user’s calls.
​
agent_id
string
Filter by specific agent ID (optional)
​
call_status
string
default:"ended"
Filter by call status: ended, ongoing, error
​
direction
string
Filter by direction: inbound or outbound
​
sentiment
string
Filter by user sentiment: Positive, Negative, Neutral, Unknown
​
call_successful
string
Filter by call success: true or false
​
start_date
string
Filter calls after this date (ISO 8601 format, e.g., 2025-01-01T00:00:00.000Z)
​
end_date
string
Filter calls before this date (ISO 8601 format, e.g., 2025-12-31T23:59:59.999Z)
​
limit
integer
default:"50"
Number of results (max: 100)

​
Response Fields

​
success
boolean
Whether the request was successful
​
calls
array
Array of call objects
​
count
integer
Total number of calls returned
​
powered_by
string
Always returns “Teli”

​
Example Request

cURL
curl -X GET "https://api.teli.ai/v1/voice/calls?organization_id=1762896364768x389173798861431550&user_id=1763661807373x532913854895880007&is_admin=false&limit=50" \
  -H "X-API-Key: YOUR_API_KEY"

​
Example Response

200
{
  "success": true,
  "count": 1,
  "calls": [
    {
      "call_id": "call_d35fab7c6bd8cf9aee6c322b7a4",
      "voice_agent_id": "agent_86f826bf8f59bacd5c10ae948a",
      "agent_id": "74014854-b110-46c8-b037-18f0149baae6",
      "agent_name": "Sales Agent",
      "organization_id": "4d051118-c116-4923-8ff4-1a9761115fec",
      "user_id": "0cf76f73-a751-4f65-b7bf-37f6cd5fdced",
      "tenant_id": "your_tenant",
      "start_timestamp": 1763660353696,
      "end_timestamp": 1763660479604,
      "call_status": "ended",
      "direction": "outbound",
      "user_sentiment": "Neutral",
      "call_successful": false,
      "in_voicemail": true,
      "from_number": "+15174686941",
      "to_number": "+15551234567",
      "recording_url": "https://teli-voice-recordings-prod.s3.us-west-2.amazonaws.com/recordings/call_d35fab7c6bd8cf9aee6c322b7a4.wav",
      "recording_s3_key": "recordings/call_d35fab7c6bd8cf9aee6c322b7a4.wav",
      "recording_downloaded_at": "2025-11-20T17:42:25.742336",
      "call_started_at": "2025-11-20T19:45:03.200769",
      "call_ended_at": "2025-11-20T19:45:02.560947",
      "call_analyzed_at": "2025-11-20T19:45:03.520027",
      "created_at": "2025-11-20T17:41:24.234773",
      "updated_at": "2025-11-20T19:45:03.621498"
    }
  ],
  "powered_by": "Teli"
}
400 (Missing Organization ID)
{
  "error": "organization_id required",
  "success": false,
  "powered_by": "Teli"
}
500 (Server Error)
{
  "error": "Failed to list calls",
  "success": false,
  "powered_by": "Teli"
}

​
Notes

  • Calls are stored in Teli Voice database after completion
  • Recordings are hosted on Teli Voice Storage (S3)
  • For full call transcript, use GET /v1/voice/calls/{call_id}
  • Admin users see all organization calls
  • Regular users see only their own calls
  • Results are ordered by start_timestamp (newest first)