IdentityCall API

The IdentityCall API lets you turn call recordings into structured, searchable, measurable data — transcription, speaker identification, emotion, goals, categories, summaries — and programmatically manage the projects, virtual numbers, and operators that produce those calls.

Start where you are

Send call audio from any PBX or recorder. Idempotent via external_id — retries are safe.

Upload recordings from your call system

Create, list, update, and delete recording projects. For integrations that provision tenants via API.

Manage projects programmatically

Route calls to the right operator

Inspect, update, and manage the phone numbers you rent through IdentityCall. Assign operators and tune routing.

Configure your virtual numbers

Quick Example

cURL


# Upload a recording (idempotent via external_id)
curl -X POST "https://api.identitycall.ai/api/v1/public/recordings" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY" \
  -F "file=@call-recording.mp3" \
  -F "project_id=42" \
  -F "external_id=crm-call-abc-123" \
  -F "language=en"
 
# Response includes public_id — use that in subsequent calls
# {"data":{"public_id":"018f3a...","status":"pending", ...}}
 
curl -X GET "https://api.identitycall.ai/api/v1/public/recordings/018f3a.../transcription" \
  -H "Authorization: Bearer $IDENTITYCALL_API_KEY"

Python


import requests
 
API_KEY = "idc_your_api_key"
BASE_URL = "https://api.identitycall.ai/api/v1/public"
 
# Upload a recording (retry-safe via external_id)
with open("call-recording.mp3", "rb") as f:
    response = requests.post(
        f"{BASE_URL}/recordings",
        headers={"Authorization": f"Bearer {API_KEY}"},
        files={"file": f},
        data={
            "project_id": 42,
            "external_id": "crm-call-abc-123",
            "language": "en",
        },
    )
recording = response.json()["data"]
 
# Retrieve transcription using the public_id UUID
response = requests.get(
    f"{BASE_URL}/recordings/{recording['public_id']}/transcription",
    headers={"Authorization": f"Bearer {API_KEY}"},
)
transcription = response.json()

Node.js


const API_KEY = process.env.IDENTITYCALL_API_KEY;
const BASE_URL = 'https://api.identitycall.ai/api/v1/public';
 
const formData = new FormData();
formData.append('file', audioFile);
formData.append('project_id', '42');
formData.append('external_id', 'crm-call-abc-123');
formData.append('language', 'en');
 
const uploadResponse = await fetch(`${BASE_URL}/recordings`, {
  method: 'POST',
  headers: { 'Authorization': `Bearer ${API_KEY}` },
  body: formData,
});
const { data: recording } = await uploadResponse.json();
 
const transcription = await fetch(
  `${BASE_URL}/recordings/${recording.public_id}/transcription`,
  { headers: { 'Authorization': `Bearer ${API_KEY}` } }
).then((r) => r.json());

Base URL

All API requests should be made to:


https://api.identitycall.ai/api/v1/public

Authentication

All API endpoints require authentication via Bearer token:


Authorization: Bearer idc_your_api_key

API keys have one of two scopes:

Account-wide keys can see every project, operator, and virtual number in the account. They must include project_id when creating a recording.
Project-scoped keys are bound to a single project and can only read or write resources inside it.

Learn more about authentication →

Need Help?

Browse the API Reference for detailed endpoint documentation.
Review the Changelog for recent changes.
Contact support at support@identitycall.ai.