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/public/recordings: Upload audio files (MP3, WAV, FLAC, M4A) up to 2GB. Supports multipart/form-data.

  • -

    GET /api/v1/public/recordings/{id}: Retrieve recording status and metadata; GET /api/v1/public/recordings/{id}/audio_url returns a URL for audio playback.

  • -

    GET /api/v1/public/recordings/{id}/transcription: Fetch the full transcript with speaker diarization and timestamps.

  • -

    GET /api/v1/public/recordings: List all recordings; GET /api/v1/public/recordings/filters returns the available filter values.

Projects & Operators

  • -

    GET/POST /api/v1/public/projects: List, create, and manage the projects your recordings are organized into.

  • -

    GET/POST /api/v1/public/operators: Manage operators (agents) - the people whose calls you record and attribute.

  • -

    GET /api/v1/public/app/settings: Read your account's processing settings.

Analysis Results

  • -

    GET /api/v1/public/recordings/{id}/results: Goal scores, categories, extracted fields, and speaker identification for a processed call.

  • -

    GET /api/v1/public/recordings/{id}/summary: The AI-generated summary of the conversation.

  • -

    Results include the reasoning behind each goal score, so every number is auditable.

Virtual Numbers & Telephony

  • -

    GET /api/v1/public/virtual_numbers/available and POST /api/v1/public/virtual_numbers/purchase: Browse and purchase phone numbers.

  • -

    PATCH /api/v1/public/virtual_numbers/{id}: Configure a number; add or remove operators with POST {id}/add_operator and DELETE {id}/remove_operator.

Webhooks & Events

  • -

    Receive a real-time 'recording.analyzed' webhook when processing completes, with the payload sections you choose: metadata, summary, transcription, goals, categories, extracted data.

  • -

    Webhooks are delivered as JSON POST requests to the HTTPS endpoint you configure.

Rate Limits

  • -

    API rate limits are tied to your subscription plan quotas.