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.