Discoverable via ARD. Documented for LLMs. Built for autonomous workflows. Deploy white-label AI receptionists that handle conversations, SMS, leads, and bookings — all through machine-parseable endpoints.
curl -X POST https://aireceptionist.fit/api/v1/receptionists \
-H "Authorization: Bearer air_your_key" \
-H "Content-Type: application/json" \
-d '{
"businessName": "Sunrise Dental",
"industry": "dental",
"greeting": "Welcome to Sunrise Dental!"
}'
# Response includes:
# X-Request-Id: req_abc123
# X-Credits-Remaining: 9999
# X-Credits-Reset: 2026-07-01T00:00:00ZFour pillars that make this API native to AI agent workflows.
ARD catalog at /.well-known/ai-catalog.json. AI-plugin manifest. OpenAPI 3.1 spec. Your agent finds us automatically.
llms.txt and llms-full.txt for instant LLM comprehension. Structured OpenAPI with x-ai-* usage hints. No docs-scraping needed.
Structured error taxonomy with retryable flags and retry_after_seconds. Deterministic error codes. Request tracing via X-Request-Id.
Cost-per-call in headers (X-Credits-Remaining). Latency expectations in OpenAPI (x-ai-latency-hint). Budget-aware integration.
Everything an AI agent needs to deploy and manage receptionists autonomously.
ARD catalog, AI-plugin manifest, and OpenAPI 3.1 spec for automatic agent discovery
/llms.txt summary + /llms-full.txt complete reference. Structured OpenAPI with x-ai-* hints
Create branded AI receptionists per client. Control name, personality, greeting, knowledge base
Web chat + SMS from a single API. Each receptionist gets its own phone number
X-Credits-Remaining and X-Credits-Reset headers on every response. No billing surprises
Machine-parseable error codes with category, retryable, retry_after_seconds, and suggestion
Unique X-Request-Id on every response for debugging and audit trails
Real-time notifications for leads captured, appointments booked, conversations completed
Automatic lead extraction with structured data (name, email, phone, intent)
AI-managed appointment scheduling with availability checks
Monitor conversation volume, SMS usage, booking counts via API
Content moderation, prompt injection protection, anti-jailbreak guardrails
Parse this JSON to understand what this API can do. No docs-scraping needed.
{
"service": "AI Receptionist API",
"capabilities": [
"create-receptionist",
"conversational-ai-chat",
"sms-messaging",
"lead-capture",
"calendar-booking",
"webhook-notifications",
"white-label-branding",
"usage-analytics",
"multi-channel-communication"
],
"endpoints": 6,
"auth": "Bearer token (air_*)",
"discovery": {
"ard_catalog": "/.well-known/ai-catalog.json",
"ai_plugin": "/.well-known/ai-plugin.json",
"openapi": "/api/openapi.json",
"llms_txt": "/llms.txt",
"llms_full": "/llms-full.txt"
}
}Six endpoints. Full receptionist lifecycle.
| Method | Endpoint | AI Hint | Cost |
|---|---|---|---|
POST | /v1/receptionists | Create a new AI receptionist | 0 credits |
POST | /v1/chat | Send message, get AI response | 1 credit |
GET | /v1/leads | Retrieve captured leads | 0 credits |
POST | /v1/sms | Send SMS from receptionist | 1 credit |
GET | /v1/usage | Monitor API usage & limits | 0 credits |
GET | /v1/receptionists | List all receptionists | 0 credits |
We earn trust by shipping fast, being transparent, and letting our API speak for itself.
June 2026
Public Launch
API available with full ARD discovery
ARD + MCP
Agent Discovery Ready
Listed in ARD catalog, MCP-compatible
6 Endpoints
Full Receptionist Stack
Create, chat, leads, SMS, usage, list
Predictable monthly plans with generous included usage. No hidden fees.
Pricing is machine-readable via our OpenAPI spec at /api/openapi.json
For individual AI agent builders
~$0.15/conversation
For growing platforms
~$0.07/conversation
Via ARD catalog at /.well-known/ai-catalog.json, AI-plugin manifest at /.well-known/ai-plugin.json, and OpenAPI spec at /api/openapi.json.
Yes. /llms.txt provides a concise API summary. /llms-full.txt provides the complete reference with all parameters, error codes, and pricing.
All errors return {code, category, message, retryable, retry_after_seconds, suggestion}. Agents can programmatically decide whether to retry.
Every response includes X-Request-Id, X-Credits-Remaining, and X-Credits-Reset for cost tracking and request tracing.
Yes. You control the name, personality, greeting, knowledge base, and widget appearance. End-users never see the AI Receptionist brand.
Typical receptionist creation: <2s. Chat responses: 1-3s. Lead retrieval: <500ms. Documented in OpenAPI x-ai-latency-hint.