Skip to main content
GET
/
v1
/
voice
/
calls
/
{call_id}
/
extractions
Get Call Extractions
curl --request GET \
  --url https://api.example.com/v1/voice/calls/{call_id}/extractions \
  --header 'X-API-Key: <x-api-key>'
{
  "success": true,
  "call_id": "call_9edb137b8014366b8cf399330da",
  "extraction_config": ["credit_score", "loan_amount", "interest_rate", "loan_type"],
  "extracted_fields": {
    "credit_score": "720",
    "loan_amount": "$350,000",
    "interest_rate": "6.5%",
    "loan_type": "30-year fixed"
  },
  "extracted_at": "2026-01-23T19:45:32Z",
  "call_status": "ended",
  "call_successful": true
}

​
Overview

Retrieve all data extracted from a voice call, including:
  • Extracted fields - Custom data points extracted from the conversation
  • Extraction config - What fields were configured for extraction
  • Lead outcome - Classification result (qualified, dnc, pending, etc.)
  • Objective status - Whether call objective was met
Extraction happens automatically after each call when extraction_fields is configured on the agent.
All extracted data is automatically white-labeled (technology provider names removed).

​
Authentication

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

​
Path Parameters

​
call_id
string
required
The call ID to retrieve extractions for

​
Response

{
  "success": true,
  "call_id": "call_9edb137b8014366b8cf399330da",
  "extraction_config": ["credit_score", "loan_amount", "interest_rate", "loan_type"],
  "extracted_fields": {
    "credit_score": "720",
    "loan_amount": "$350,000",
    "interest_rate": "6.5%",
    "loan_type": "30-year fixed"
  },
  "extracted_at": "2026-01-23T19:45:32Z",
  "call_status": "ended",
  "call_successful": true
}

​
Response Fields

​
success
boolean
Whether the request was successful
​
call_id
string
The call identifier
​
extraction_config
array
List of fields that were configured for extraction on the agent
​
extracted_fields
object
JSONB object containing all extracted key-value pairsExample:
{
  "credit_score": "720",
  "loan_amount": "$350,000",
  "interest_rate": "6.5%"
}
​
extracted_at
string
ISO timestamp when data was extracted
​
call_status
string
Call status: ended, ongoing, error
​
call_successful
boolean
Whether the call was successful

​
Request Examples

curl -X GET "https://api.teli.ai/v1/voice/calls/call_9edb137b8014366b8cf399330da/extractions" \
  -H "X-API-Key: YOUR_API_KEY"

​
Get Extractions by Phone Number

Endpoint: GET /v1/voice/extractions/phone/{phone_number} Retrieve all extractions for a specific phone number across all calls.

​
Path Parameters

​
phone_number
string
required
Phone number in E.164 format (e.g., +15551234567)

​
Query Parameters

​
organization_id
string
required
Organization unique_id to filter by
​
limit
number
default:"50"
Maximum results to return (max: 100)

​
Response

200 - Success
{
  "success": true,
  "phone_number": "+15551234567",
  "extractions": [
    {
      "call_id": "call_xxx",
      "extracted_fields": {
        "credit_score": "720",
        "loan_amount": "$350,000"
      },
      "extraction_config": ["credit_score", "loan_amount", "interest_rate"],
      "lead_outcome": "qualified",
      "objective_met": true,
      "call_date": 1763586795333,
      "call_duration_ms": 57610,
      "call_successful": true,
      "extracted_at": "2026-01-23T19:45:32Z"
    },
    {
      "call_id": "call_yyy",
      "extracted_fields": {
        "interested": "no"
      },
      "lead_outcome": "dnc",
      "objective_met": false,
      "call_date": 1763486795333,
      "call_duration_ms": 25000,
      "extracted_at": "2026-01-22T14:20:15Z"
    }
  ],
  "count": 2
}

​
Request Example

cURL
curl -X GET "https://api.teli.ai/v1/voice/extractions/phone/+15551234567?organization_id=org_xxx" \
  -H "X-API-Key: YOUR_API_KEY"

​
Use Cases

​
Lead Qualification

Extract key qualifying information: 
"extraction_fields": ["budget", "timeline", "credit_score", "interested"]

​
Customer Support

Capture support details: 
"extraction_fields": ["issue_type", "account_number", "resolution_needed", "satisfaction"]

​
Appointment Scheduling

Extract booking details: 
"extraction_fields": ["preferred_date", "preferred_time", "appointment_reason", "special_requests"]

​
Sales Calls

Capture deal information: 
"extraction_fields": ["product_interest", "quantity", "budget", "decision_timeframe", "decision_maker"]

​
Best Practices

Keep fields simple - Use clear, descriptive field names (e.g., email, phone_number, budget)
Limit field count - Extract 5-10 fields max per call for best results
Configure on agent - Set extraction_fields when creating agent for automatic extraction
Poll for results - Use Get Call Details endpoint to check when extraction is complete

​
Notes

  • Extraction happens automatically after call ends (not during call)
  • Results available within 5-10 seconds of call completion
  • Empty extracted_fields means either:
    • No extraction_fields configured on agent
    • Call ended before information could be gathered
    • Transcript didn’t contain requested information
  • All field keys and values are automatically white-labeled