# InfiVoice Introduction API

**Canonical:** https://apis.io/apis/infivoice/infivoice-introduction-api/  
**Provider:** InfiVoice — https://apis.io/providers/infivoice/  
**Base URL:** https://infivoice.com/api/v1  
**Documentation:** https://infivoice.com/api/docs

InfiVoice Introduction API is one of 8 APIs that [InfiVoice](https://apis.io/providers/infivoice/) publishes on the [APIs.io](https://apis.io/) network, described by a machine-readable OpenAPI specification. This API exposes 6 JSON Schema definitions. Tagged areas include Introduction. The published artifact set on APIs.io includes an OpenAPI specification and 6 JSON Schemas.

InfiVoice provides a powerful REST API for automating AI-powered voice calls. Whether you're building customer outreach, appointment reminders, lead qualification, or interactive voice applications, our API gives you full control. <br /><br /> --- <br /> <br /> Navigate to your InfiVoice dashboard → API Keys page (left sidebar, /app/api-keys) to create an API key. Keep this key secure—it provides full access to your account. <br /> Test your connection with a simple health check: ```bash curl -X GET "https://infivoice.com/api/v1/health" ``` <br /> Include your API key in every request using one of these methods: ```bash curl -H "Authorization: Bearer YOUR_API_KEY" ... curl -H "X-API-Key: YOUR_API_KEY" ... ``` <br /><br /> --- <br /> <br /> | Concept | Description | |---------|-------------| | **Agents** | AI voice agents that handle conversations. Two types: Flow (visual conversation builder) and Incoming (for inbound calls). | | **Campaigns** | Bulk calling operations targeting multiple contacts with the same agent. | | **Calls** | Individual voice call records with transcripts, recordings, and analytics. | | **Contacts** | Your CRM leads with phone numbers, custom fields, and AI-enriched data. | | **Credits** | Billing units where 1 credit = 1 minute of call time. | | **Webhooks** | Real-time event notifications delivered to your endpoints. | <br /><br /> --- <br /> InfiVoice supports three telephony engines for different use cases: <br /> | Engine | AI Provider | Best For | |--------|-------------|----------| | `elevenlabs` | ElevenLabs Conversational AI | High-quality voices, 29 languages | | `plivo` | OpenAI Realtime API | India and APAC regions | | `twilio-openai` | OpenAI Realtime API | Global coverage, reliable routing | <br /><br /> --- <br /> All API endpoints (except `/health`) require authentication. Include your API key in every request: <br /> - **Authorization Header**: `Authorization: Bearer YOUR_API_KEY` - **X-API-Key Header**: `X-API-Key: YOUR_API_KEY` <br /> API keys have scoped permissions. Ensure your key has the required scopes for the endpoints you're accessing. <br /><br /> --- <br /> Requests are rate-limited based on your subscription plan: <br /> | Plan | Limit | |------|-------| | Free | 60 requests/minute | | Pro | 300 requests/minute | | Enterprise | 1000 requests/minute | <br /> **Rate limit headers in responses:** - `X-RateLimit-Limit` — Maximum requests per window - `X-RateLimit-Remaining` — Remaining requests - `X-RateLimit-Reset` — Unix timestamp when window resets <br /><br /> --- <br /> <br /> ```json { "success": true, "data": { ... }, "meta": { "requestId": "uuid", "timestamp": "2024-01-01T00:00:00.000Z" } } ``` <br /> ```json { "success": false, "error": { "code": "ERROR_CODE", "message": "Human readable message", "details": { ... } }, "meta": { ... } } ``` <br /><br /> --- <br /> <br /> | Code | HTTP Status | Description | |------|-------------|-------------| | `VALIDATION_ERROR` | 400 | Invalid request parameters | | `UNAUTHORIZED` | 401 | Missing or invalid API key | | `FORBIDDEN` | 403 | Insufficient permissions | | `NOT_FOUND` | 404 | Resource not found | | `INSUFFICIENT_CREDITS` | 402 | Not enough credits | | `RATE_LIMIT_EXCEEDED` | 429 | Too many requests | <br />

## Operations (1)

| Method | Path | Summary |
|---|---|---|
| GET | `/health` | Health Check |

## Machine-readable artifacts (7)

- **OpenAPI** — https://artifacts.apis.io/infivoice/openapi/infivoice-introduction-api-openapi.yml
- **JSONSchema** — https://artifacts.apis.io/infivoice/json-schema/infivoice-create-campaign-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/infivoice/json-schema/infivoice-trigger-call-request-schema.json
- **JSONSchema** — https://artifacts.apis.io/infivoice/json-schema/infivoice-credit-usage-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/infivoice/json-schema/infivoice-campaign-analytics-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/infivoice/json-schema/infivoice-analytics-summary-response-schema.json
- **JSONSchema** — https://artifacts.apis.io/infivoice/json-schema/infivoice-create-webhook-request-schema.json

## Other InfiVoice APIs (7)

- [InfiVoice Agents API](https://apis.io/apis/infivoice/infivoice-agents-api/)
- [InfiVoice Analytics API](https://apis.io/apis/infivoice/infivoice-analytics-api/)
- [InfiVoice Calls API](https://apis.io/apis/infivoice/infivoice-calls-api/)
- [InfiVoice Campaigns API](https://apis.io/apis/infivoice/infivoice-campaigns-api/)
- [InfiVoice Contacts API](https://apis.io/apis/infivoice/infivoice-contacts-api/)
- [InfiVoice Credits API](https://apis.io/apis/infivoice/infivoice-credits-api/)
- [InfiVoice Webhooks API](https://apis.io/apis/infivoice/infivoice-webhooks-api/)

## Tags

Introduction

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/apis/infivoice/infivoice-introduction-api/). The API's provider profile, Kin Score and agent-readiness rating are at https://apis.io/providers/infivoice/.