API Overview
The Aila REST API provides programmatic access to call records, transcripts, custom extractions, QA scorecards, and batch ingest workflows.
Base URL
All REST API endpoints use the following base URL:
https://app.aila.fyi/api/v1Authentication
Authenticate all API requests by passing an API key in the Authorization HTTP header:
Authorization: Bearer <YOUR_API_KEY>See the Authentication Guide to generate and manage keys.
Core Endpoints
Calls
| Method & Endpoint | Description |
|---|---|
GET /calls | Query call records with date, agent, and pagination filters. |
GET /calls/{call_id} | Retrieve complete call details, transcript, and AI summary. |
POST /calls/upload | Upload a single audio or video recording file for processing. |
POST /calls/batch-upload | Ingest multiple audio recordings (1–100) in a single batch. |
GET /calls/{call_id}/scorecard | Retrieve QA scorecard criteria and evaluation results. |
Contacts
| Method & Endpoint | Description |
|---|---|
GET /contacts | List customer contact profiles with aggregated call metrics. |
GET /contacts/{contact_id} | Retrieve contact details, conversation history, and CRM IDs. |
Analytics
| Method & Endpoint | Description |
|---|---|
GET /analytics/team-metrics | Retrieve aggregated team call volume, duration, and speed-to-lead. |
Rate Limits
| Plan | Hourly Limit |
|---|---|
| Standard | 1,000 requests / hour |
| Enterprise | Custom limits |
Response headers include standard rate limit status:
X-RateLimit-Limit: Maximum requests per window.X-RateLimit-Remaining: Available requests in the current window.X-RateLimit-Reset: Unix timestamp when the limit resets.
Related Documentation
- Authentication: API key generation and security.
- Batch Upload: Ingest call archives at scale.
- Outbound Webhooks: Real-time event subscriptions.