Skip to main content

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.

Get API access