API Reference

CallSpoke REST API

The CallSpoke API allows you to programmatically upload recordings, retrieve transcripts, and manage your account. All API requests require authentication using your API key.

Authentication

Include your API key in the Authorization header of all requests:

Authorization: Bearer YOUR_API_KEY

Base URL

https://api.callspoke.com/v1

Core Endpoints

Upload Recording

POST /recordings

Upload a call recording for transcription.

curl -X POST https://api.callspoke.com/v1/recordings 
  -H "Authorization: Bearer YOUR_API_KEY" 
  -F "audio=@/path/to/recording.wav" 
  -F "metadata={"caller_id":"+15551234567","call_date":"2025-01-15T10:30:00Z"}"

Get Transcript

GET /transcripts/{id}

Retrieve a transcript by ID.

curl -X GET https://api.callspoke.com/v1/transcripts/abc123 
  -H "Authorization: Bearer YOUR_API_KEY"

List Transcripts

GET /transcripts

List all transcripts with optional filters.

curl -X GET "https://api.callspoke.com/v1/transcripts?start_date=2025-01-01&limit=50" 
  -H "Authorization: Bearer YOUR_API_KEY"

Get AI Analysis

GET /transcripts/{id}/analysis

Retrieve AI-powered analysis for a transcript.

Webhooks

Configure webhooks in your dashboard to receive real-time notifications when:

• Transcription completes
• AI analysis is ready
• Processing errors occur

Rate Limits

• Standard: 1,000 requests per hour
• Enterprise: Custom rate limits available

Error Codes

• 400 – Bad Request: Invalid parameters
• 401 – Unauthorized: Invalid or missing API key
• 404 – Not Found: Resource doesn’t exist
• 429 – Rate Limit Exceeded
• 500 – Internal Server Error