Build with our API
Integrate identitycall.ai seamlessly.
Authentication
- -
Authenticate requests using Bearer tokens. All API requests must include 'Authorization: Bearer <YOUR_API_KEY>' header.
- -
Generate and manage API keys from your account dashboard. Keys are scoped to your account and should be kept secret.
Recordings & Transcription
- -
POST /api/v1/recordings: Upload audio files (MP3, WAV, FLAC, M4A) up to 2GB. Supports multipart/form-data.
- -
GET /api/v1/recordings/{id}: Retrieve recording status, metadata, and signed URL for audio playback.
- -
GET /api/v1/recordings/{id}/transcript: Fetch full transcript with speaker diarization, timestamps, and confidence scores.
- -
GET /api/v1/recordings: List all recordings with filtering by date, status, and project.
Voice Biometrics & Profiles
- -
POST /api/v1/voice_profiles: Create a new voice profile for a speaker. Requires a clear audio sample for enrollment.
- -
POST /api/v1/voice_profiles/identify: Identify speakers in an audio segment. Returns matching profiles with confidence scores.
- -
GET /api/v1/voice_profiles: Manage your library of known speakers and their enrollment status.
Analytics & Insights
- -
GET /api/v1/recordings/{id}/analytics: Retrieve emotion analysis, sentiment scores, and talk-time metrics.
- -
GET /api/v1/recordings/{id}/goals: Get results of AI-evaluated custom goals (e.g., 'Did the agent mention the promotion?').
- -
GET /api/v1/recordings/{id}/keywords: Text keyword occurrences with sentiment contexts.
Virtual Numbers & Telephony
- -
POST /api/v1/virtual_numbers: Provision new phone numbers (local/toll-free) dynamically.
- -
PATCH /api/v1/virtual_numbers/{id}: Configure call forwarding, recording settings, and webhooks.
Webhooks & Events
- -
Receive real-time notifications for 'recording.completed', 'recording.transcribed', and 'call.inbound'.
- -
Secure your webhooks by verifying signatures.
Rate Limits
- -
API rate limits are tied to your subscription plan quotas.