Skip to main content
GET
/
summaries
/
{id}
curl https://api.bota.dev/v1/summaries/sum_abc123 \
  -H "Authorization: Bearer sk_live_..."

{
  "id": "sum_abc123",
  "recording_id": "rec_abc123",
  "transcription_id": "txn_def456",
  "template_id": "sales_call",
  "status": "pending",
  "output": null,
  "error": null,
  "created_at": "2025-01-15T10:20:00Z",
  "completed_at": null
}
Retrieve the status and result of a summary job. Poll this endpoint until status is completed or failed, or use webhooks for real-time notifications.
​
id
string
required
The summary’s unique identifier (e.g., sum_abc123).
curl https://api.bota.dev/v1/summaries/sum_abc123 \
  -H "Authorization: Bearer sk_live_..."

{
  "id": "sum_abc123",
  "recording_id": "rec_abc123",
  "transcription_id": "txn_def456",
  "template_id": "sales_call",
  "status": "pending",
  "output": null,
  "error": null,
  "created_at": "2025-01-15T10:20:00Z",
  "completed_at": null
}

​
Output by Template

The output field structure varies by template:

​
sales_call

{
  "pain_points": ["string"],
  "budget": "string",
  "next_steps": ["string"],
  "key_quotes": ["string"]
}

​
clinical_soap

{
  "subjective": "string",
  "objective": "string",
  "assessment": "string",
  "plan": "string"
}

{
  "facts": "string",
  "issues": ["string"],
  "analysis": "string",
  "conclusion": "string"
}

​
general_notes

{
  "key_points": ["string"],
  "action_items": ["string"],
  "decisions": ["string"]
}

​
Error Codes

CodeDescription
transcript_too_shortTranscript is too short to summarize
template_not_foundSpecified template_id does not exist
processing_errorInternal processing error